Order

Version 2019-04

An order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provide an email address or phone number, billing address and payment information.

Orders can be created through the API, but no payment information will be collected, and no transaction performed. You can mark the order with any payment status.

You can also allow merchants to create orders manually by using the DraftOrder resource.

Caution

You can't use the Order resource to create a new checkout for an individual store. To create a checkout, you need to use the Checkout API, or an SDK powered by the Storefront API, such as the JavaScript Buy SDK, iOS Buy SDK, or Android Buy SDK.

Caution

As of June 6th, 2018, only the last 60 days' worth of orders from a store will be accessible from the Order resource by default. If you want to access older orders, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders scope to your app along with read_orders or write_orders. Private apps are not affected by this change and are automatically granted the scope.

After an order is created, you can change only a few of its attributes using the API. You cannot change the items or the quantities in an order.

You can also add metafields to the Order resource.

What you can do with Order

The Shopify API lets you do the following with the Order resource. More detailed versions of these general actions may be available:

Order properties

app_id
read-only
"app_id": 1966818

The ID of the app that created the order.

billing_address
"billing_address": {
  "address1": "2259 Park Ct",
  "address2": "Apartment 5",
  "city": "Drayton Valley",
  "company": null,
  "country": "Canada",
  "first_name": "Christopher",
  "last_name": "Gorski",
  "phone": "(555)555-5555",
  "province": "Alberta",
  "zip": "T0E 0M0",
  "name": "Christopher Gorski",
  "province_code": "AB",
  "country_code": "CA",
  "latitude": "45.41634",
  "longitude": "-75.6868"
}

The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. It has the following properties:

  • address1: The street address of the billing address.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city, town, or village of the billing address.
  • company: The company of the person associated with the billing address.
  • country: The name of the country of the billing address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the billing address.
  • first_name: The first name of the person associated with the payment method.
  • last_name: The last name of the person associated with the payment method.
  • latitude: The latitude of the billing address.
  • longitude: The longitude of the billing address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the billing address.
  • province: The name of the region (province, state, prefecture, …) of the billing address.
  • province_code: The two-letter abbreviation of the region of the billing address.
  • zip: The postal code (zip, postcode, Eircode, …) of the billing address.
browser_ip
read-only
"browser_ip": "216.191.105.146"

The IP address of the browser used by the customer when they placed the order.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer consented to receive email updates from the shop.

cancel_reason
"cancel_reason": "customer"

The reason why the order was canceled. Valid values:

  • customer: The customer canceled the order.
  • fraud: The order was fraudulent.
  • inventory: Items in the order were not in inventory.
  • declined: The payment was declined.
  • other: A reason not in this list.
cancelled_at
read-only
"cancelled_at": null

The date and time ( ISO 8601 format) when the order was canceled.

cart_token
read-only
"cart_token": "68778783ad298f1c80c3bafcddeea"

The ID of the cart that's associated with the order.

client_details
read-only
"client_details": {
  "accept_language": "en-US,en;q=0.9",
  "browser_height": 1320,
  "browser_ip": "216.191.105.146",
  "browser_width": 1280,
  "session_hash": "9ad4d1f4e6a8977b9dd98eed1e477643",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36"
}

Information about the browser that the customer used when they placed their order:

  • accept_language: The languages and locales that the browser understands.
  • browser_height: The browser screen height in pixels, if available.
  • browser_ip: The browser IP address.
  • browser_width: The browser screen width in pixels, if available.
  • session_hash: A hash of the session.
  • user_agent: Details of the browsing client, including software and operating versions.
closed_at
read-only
"closed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the order was closed.

created_at
read-only
"created_at": "2008-01-10T11:00:00-05:00"

The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the shop currency.

customer
"customer": {
  "id": 207119551,
  "email": "bob.norman@hostmail.com",
  "accepts_marketing": false,
  "created_at": "2012-03-13T16:09:55-04:00",
  "updated_at": "2012-03-13T16:09:55-04:00",
  "first_name": "Bob",
  "last_name": "Norman",
  "orders_count": "1",
  "state": "disabled",
  "total_spent": "0.00",
  "last_order_id": 450789469,
  "note": null,
  "verified_email": true,
  "multipass_identifier": null,
  "tax_exempt": false,
  "phone": "+13125551212",
  "tags": "loyal",
  "last_order_name": "#1001",
  "currency": "USD",
  "addresses": {},
  "admin_graphql_api_id": "gid://shopify/Customer/207119551",
  "default_address": {}
}

Information about the customer. The order might not have a customer and apps should not depend on the existence of a customer object. This value might be null if the order was created through Shopify POS. For more information about the customer object, see the Customer resource.

customer_locale
read-only
"customer_locale": "en-CA"

The two or three-letter language code, optionally followed by a region modifier.

discount_applications
read-only
"discount_applications": [
  {
    "type": "manual",
    "title": "custom discount",
    "description": "customer deserved it",
    "value": "2.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "line_item"
  },
  {
    "type": "script",
    "description": "my scripted discount",
    "value": "5.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "shipping_line"
  },
  {
    "type": "discount_code",
    "code": "SUMMERSALE",
    "value": "10.0",
    "value_type": "fixed_amount",
    "allocation_method": "across",
    "target_selection": "all",
    "target_type": "line_item"
  }
]

An ordered list of stacked discount applications.

The discount_applications property includes 3 types: discount_code, manual, and script. All 3 types share a common structure and have some type specific attributes.

  • allocation_method: The method by which the discount application value has been allocated to entitled lines. Valid values:
    • across: The value is spread across all entitled lines.
    • each: The value is applied onto every entitled line.
    • one: The value is applied onto a single line.
  • code: The discount code that was used to apply the discount. Available only for discount code applications.
  • description: The description of the discount application, as defined by the merchant or the Shopify Script. Available only for manual and script discount applications.
  • target_selection: The lines on the order, of the type defined by target_type, that the discount is allocated over. Valid values:
    • all: The discount is allocated onto all lines,
    • entitled: The discount is allocated only onto lines it is entitled for.
    • explicit: The discount is allocated onto explicitly selected lines.
  • target_type: The type of line on the order that the discount is applicable on. Valid values:
    • line_item: The discount applies to line items.
    • shipping_line: The discount applies to shipping lines.
  • title: The title of the discount application, as defined by the merchant. Available only for manual discount applications.
  • type: The discount application type. Valid values:
    • manual: The discount was manually applied by the merchant (for example, by using an app or creating a draft order).
    • script: The discount was applied by a Shopify Script.
    • discount_code: The discount was applied by a discount code.
  • value: The value of the discount application as a decimal. This represents the intention of the discount application. For example, if the intent was to apply a 20% discount, then the value will be 20.0. If the intent was to apply a $15 discount, then the value will be 15.0.
  • value_type: The type of the value. Valid values:
    • fixed_amount: A fixed amount discount value in the currency of the order.
    • percentage: A percentage discount value.
discount_codes
"discount_codes": [
  {
    "code": "SPRING30",
    "amount": "30.00",
    "type": "fixed_amount"
  }
]

A list of discount codes to apply to the order. Each discount code object includes the following fields:

  • amount: The value of the discount to be deducted from the order total. The type field determines how this value is calculated. After an order is created, this field returns the calculated amount.
  • code: The discount code.
  • type: The type of discount. Default value: fixed_amount. Valid values:
    • fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied.
    • percentage: Applies a discount of amount as a percentage of the order total.
    • shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30.
email
"email": "bob.norman@hostmail.com"

The customer's email address.

financial_status
"financial_status": "authorized"

The status of payments associated with the order. Can only be set when the order is created. Valid values:

  • pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully.
  • authorized: The payments have been authorized.
  • partially_paid: The order have been partially paid.
  • paid: The payments have been paid.
  • partially_refunded: The payments have been partially refunded.
  • refunded: The payments have been refunded.
  • voided: The payments have been voided.
fulfillments
"fulfillments": [
  {
    "created_at": "2012-03-13T16:09:54-04:00",
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "tracking_company": null,
    "tracking_number": "1Z2345",
    "updated_at": "2012-05-01T14:22:25-04:00"
  }
]

A list of fulfillments associated with the order. For more information, see the Fulfillment API.

fulfillment_status
"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
gateway
deprecated
"gateway": "shopify_payments"

The payment gateway used.

Use the Transaction resource instead.

id
read-only
"id": 450789469

The ID of the order, used for API purposes. This is different from the order_number property, which is the ID used by the shop owner and customer.'

landing_site
read-only
"landing_site": "http://www.example.com?source=abc"

The URL for the page where the buyer landed when they entered the shop.

line_items
required
"line_items": [
  {
    "fulfillable_quantity": 1,
    "fulfillment_service": "amazon",
    "fulfillment_status": "fulfilled",
    "grams": 500,
    "id": 669751112,
    "price": "199.99",
    "product_id": 7513594,
    "quantity": 1,
    "requires_shipping": true,
    "sku": "IPOD-342-N",
    "title": "IPod Nano",
    "variant_id": 4264112,
    "variant_title": "Pink",
    "vendor": "Apple",
    "name": "IPod Nano - Pink",
    "gift_card": false,
    "price_set": {
      "shop_money": {
        "amount": "199.99",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "173.30",
        "currency_code": "EUR"
      }
    },
    "properties": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday Mom!"
      }
    ],
    "taxable": true,
    "tax_lines": [
      {
        "title": "HST",
        "price": "25.81",
        "price_set": {
          "shop_money": {
            "amount": "25.81",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "20.15",
            "currency_code": "EUR"
          }
        },
        "rate": 0.13
      }
    ],
    "total_discount": "5.00",
    "total_discount_set": {
      "shop_money": {
        "amount": "5.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "4.30",
        "currency_code": "EUR"
      }
    },
    "discount_allocations": [
      {
        "amount": "5.00",
        "discount_application_index": 2,
        "amount_set": {
          "shop_money": {
            "amount": "5.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "3.96",
            "currency_code": "EUR"
          }
        }
      }
    ]
  }
]

A list of line item objects, each containing information about an item in the order. Each object has the following properties:

  • fulfillable_quantity: The amount available to fulfill, calculated as follows:
    quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity
  • fulfillment_service: The service provider that's fulfilling the item. Valid values: manual, or the name of the provider, such as amazon or shipwire.
  • fulfillment_status: How far along an order is in terms line items fulfilled. Valid values: null, fulfilled, partial, and not_eligible.
  • grams: The weight of the item in grams.
  • id: The ID of the line item.
  • price: The price of the item before discounts have been applied in the shop currency.
  • price_set: The price of the line item in shop and presentment currencies.
  • product_id: The ID of the product that the line item belongs to. Can be null if the original product associated with the order is deleted at a later date.
  • quantity: The number of items that were purchased.
  • requires_shipping: Whether the item requires shipping.
  • sku: The item's SKU (stock keeping unit).
  • title: The title of the product.
  • variant_id: The ID of the product variant.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.
  • name: The name of the product variant.
  • gift_card: Whether the item is a gift card. If true, then the item is not taxed or considered for shipping charges.
  • properties: An array of custom information for the item that has been added to the cart. Often used to provide product customization options. For more information, see Get customization information for products with line item properties.
  • taxable: Whether the item was taxable.
  • tax_lines: A list of tax line objects, each of which details a tax applied to the item.
    • title: The name of the tax.
    • price: The amount added to the order for this tax in the shop currency.
    • price_set: The amount added to the order for this tax in shop and presentment currencies.
    • rate: The tax rate applied to the order to calculate the tax price.
  • tip_payment_gateway: The payment gateway used to tender the tip, such as shopify_payments. Present only on tips.
  • tip_payment_method: The payment method used to tender the tip, such as Visa. Present only on tips.
  • total_discount: The total discount amount applied to this line item in the shop currency. This value is not subtracted in the line item price.
  • total_discount_set: The total discount applied to the line item in shop and presentment currencies.
  • discount_allocations: An ordered list of amounts allocated by discount applications. Each discount allocation is associated to a particular discount application.
    • amount: The discount amount allocated to the line in the shop currency.
    • discount_application_index: The index of the associated discount application in the order's discount_applications list.
    • amount_set: The discount amount allocated to the line item in shop and presentment currencies.
location_id
"location_id": 49202758

The ID of the physical location where the order was processed.

name
read-only
"name": "#1001"

The order name as represented by a number. Must start with #.

note
"note": "Customer changed their mind."

An optional note that a shop owner can attach to the order.

note_attributes
"note_attributes": [
  {
    "name": "custom name",
    "value": "custom value"
  }
]

Extra information that is added to the order. Appears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.

number
read-only
"number": 1000

For internal use only. An ID unique to the shop. Numbers are sequential and start at 1000.

order_number
read-only
"order_number": 1001

The ID of the order used by the shop owner and customer. This is different from the id property, which is the ID of the order used by the API.

payment_details
deprecated
"payment_details": {
  "avs_result_code": "Y",
  "credit_card_bin": "453600",
  "cvv_result_code": "M",
  "credit_card_number": "•••• •••• •••• 4242",
  "credit_card_company": "Visa"
}

An object containing information about the payment. It has the following properties:

  • avs_result_code: The response code from the address verification system (AVS). The code is a single letter. See this chart for the codes and their definitions.
  • credit_card_bin: The issuer identification number (IIN), formerly known as the bank identification number (BIN), of the customer's credit card. This is made up of the first few digits of the credit card number.
  • credit_card_company: The name of the company who issued the customer's credit card.
  • credit_card_number: The customer's credit card number, with most of the leading digits redacted.
  • cvv_result_code: The response code from the credit card company indicating whether the customer entered the card security code (card verification value) correctly. The code is a single letter or empty string. See this chart for the codes and their definitions.

Use the Transaction resource instead.

payment_gateway_names
read-only
"payment_gateway_names": [
  "authorize_net",
  "Cash on Delivery (COD)"
]

The list of payment gateways used for the order.

phone
"phone": "+557734881234"

The customer's phone number for receiving SMS notifications.

presentment_currency
"presentment_currency": "CAD"

The presentment currency that was used to display prices to the customer.

processed_at
"processed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created.

processing_method
read-only
"processing_method": "direct"

How the payment was processed. It has the following valid values:

referring_site
"referring_site": "http://www.anexample.com"

The website where the customer clicked a link to the shop.

refunds
read-only
"refunds": [
  {
    "id": 18423447608,
    "order_id": 394481795128,
    "created_at": "2018-03-06T09:35:37-05:00",
    "note": null,
    "user_id": null,
    "processed_at": "2018-03-06T09:35:37-05:00",
    "refund_line_items": [],
    "transactions": [],
    "order_adjustments": []
  }
]

A list of refunds applied to the order. For more information, see the Refund API.

shipping_address
"shipping_address": {
  "address1": "123 Amoebobacterieae St",
  "address2": "",
  "city": "Ottawa",
  "company": null,
  "country": "Canada",
  "first_name": "Bob",
  "last_name": "Bobsen",
  "latitude": "45.41634",
  "longitude": "-75.6868",
  "phone": "555-625-1199",
  "province": "Ontario",
  "zip": "K2P0V6",
  "name": "Bob Bobsen",
  "country_code": "CA",
  "province_code": "ON"
}

The mailing address to where the order will be shipped. This address is optional and will not be available on orders that do not require shipping. It has the following properties:

  • address1: The street address of the shipping address.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city, town, or village of the shipping address.
  • company: The company of the person associated with the shipping address.
  • country: The name of the country of the shipping address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • latitude: The latitude of the shipping address.
  • longitude: The longitude of the shipping address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the shipping address.
  • province: The name of the region (province, state, prefecture, …) of the shipping address.
  • province_code: The two-letter abbreviation of the region of the shipping address.
  • zip: The postal code (zip, postcode, Eircode, …) of the shipping address.
shipping_lines
"shipping_lines": [
  {
    "code": "INT.TP",
    "price": "4.00",
    "price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "discounted_price": "4.00",
    "discounted_price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "source": "canada_post",
    "title": "Small Packet International Air",
    "tax_lines": [],
    "carrier_identifier": "third_party_carrier_identifier",
    "requested_fulfillment_service_id": "third_party_fulfillment_service_id"
  }
]

An array of objects, each of which details a shipping method used. Each object has the following properties:

  • code: A reference to the shipping method.
  • discounted_price: The price of the shipping method after line-level discounts have been applied. Doesn't reflect cart-level or order-level discounts.
  • discounted_price_set: The price of the shipping method in both shop and presentment currencies after line-level discounts have been applied.
  • price: The price of this shipping method in the shop currency. Can't be negative.
  • price_set: The price of the shipping method in shop and presentment currencies.
  • source: The source of the shipping method.
  • title: The title of the shipping method.
  • tax_lines: A list of tax line objects, each of which details a tax applicable to this shipping line.
  • carrier_identifier: A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
  • requested_fulfillment_service_id: A reference to the fulfillment service that is being requested for the shipping method. Present if the shipping method requires processing by a third party fulfillment service; null otherwise.
source_name
"source_name": "web"

Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, shopify_draft_order, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value of your app's ID.

subtotal_price
"subtotal_price": 398.0

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

subtotal_price_set
"subtotal_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The subtotal of the order in shop and presentment currencies.

tags
"tags": "imported"

Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length.

tax_lines
"tax_lines": [
  {
    "price": 11.94,
    "rate": 0.06,
    "title": "State Tax"
  }
]

An array of tax line objects, each of which details a tax applicable to the order. Each object has the following properties:

  • price: The amount of tax to be charged in the shop currency.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.
When creating an order through the API, tax lines can be specified on the order or the line items but not both. Tax lines specified on the order are split across the taxable line items in the created order.
taxes_included
"taxes_included": false

Whether taxes are included in the order subtotal.

test
"test": true

Whether this is a test order.

token
read-only
"token": "b1946ac92492d2347c6235b4d2611184"

A unique token for the order.

total_discounts
"total_discounts": "0.00"

The total discounts applied to the price of the order in the shop currency.

total_discounts_set
"total_discounts_set": {
  "shop_money": {
    "amount": "0.00",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "0.00",
    "currency_code": "EUR"
  }
}

The total discounts applied to the price of the order in shop and presentment currencies.

total_line_items_price
"total_line_items_price": "398.00"

The sum of all line item prices in the shop currency.

total_line_items_price_set
"total_line_items_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The total of all line item prices in shop and presentment currencies.

total_price
"total_price": "409.94"

The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive.

total_price_set
"total_price_set": {
  "shop_money": {
    "amount": "164.86",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "105.31",
    "currency_code": "EUR"
  }
}

The total price of the order in shop and presentment currencies.

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the order in th shop currency. Must be positive).

total_tax_set
"total_tax_set": {
  "shop_money": {
    "amount": "18.87",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "11.82",
    "currency_code": "EUR"
  }
}

The total tax applied to the order in shop and presentment currencies.

total_tip_received
"total_tip_received": "4.87"

The sum of all the tips in the order in the shop currency.

total_weight
"total_weight": 300

The sum of all line item weights in grams.

updated_at
read-only
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format) when the order was last modified.

Filtering orders by updated_at is not an effective method for fetching orders because its value can change when no visible fields of an order have been updated. Use the Webhook and Event APIs to subscribe to order events instead.

user_id
"user_id": 31522279

The ID of the user logged into Shopify POS who processed the order, if applicable.

order_status_url
read-only
"order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35"

The URL pointing to the order status web page, if applicable.

Endpoints

GET /admin/api/2019-04/orders.json
Retrieves a list of orders.
ids

Retrieve only orders specified by a comma-separated list of order IDs.

limit

The maximum number of results to show on a page.

(default: 50, maximum: 250)
page
deprecated

The page of results to show.

(default: 1)
since_id

Show orders after the specified ID.

created_at_min

Show orders created at or after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Show orders created at or before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Show orders last updated at or after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Show orders last updated at or before date (format: 2014-04-25T16:15:47-04:00).

processed_at_min

Show orders imported at or after date (format: 2014-04-25T16:15:47-04:00).

processed_at_max

Show orders imported at or before date (format: 2014-04-25T16:15:47-04:00).

attribution_app_id

Show orders attributed to a certain app, specified by the app ID. Set as current to show orders for the app currently consuming the API.

status

Filter orders by their status.

(default: open)
  • open: Show only open orders.
  • closed: Show only closed orders.
  • cancelled: Show only canceled orders.
  • any: Show orders of any status, including archived orders.
financial_status

Filter orders by their financial status.

(default: any)
  • authorized: Show only authorized orders
  • pending: Show only pending orders
  • paid: Show only paid orders
  • partially_paid: Show only partially paid orders
  • refunded: Show only refunded orders
  • voided: Show only voided orders
  • partially_refunded: Show only partially refunded orders
  • any: Show orders of any financial status.
  • unpaid: Show authorized and partially paid orders.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve all orders

GET /admin/api/2019-04/orders.json
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=cdfb71699e69d7ac5f1de2026e8f331e",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve specific orders

GET /admin/api/2019-04/orders.json?ids=1073459983
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 1073459983,
      "email": "",
      "closed_at": null,
      "created_at": "2019-10-16T16:05:04-04:00",
      "updated_at": "2019-10-16T16:05:04-04:00",
      "number": 2,
      "note": null,
      "token": "859d376ed1cc03345c0a1b529a693463",
      "gateway": "",
      "test": false,
      "total_price": "199.00",
      "subtotal_price": "199.00",
      "total_weight": 0,
      "total_tax": "0.00",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "paid",
      "confirmed": true,
      "total_discounts": "0.00",
      "total_line_items_price": "199.00",
      "cart_token": null,
      "buyer_accepts_marketing": false,
      "name": "#1002",
      "referring_site": null,
      "landing_site": null,
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "199.00",
      "checkout_token": null,
      "reference": null,
      "user_id": null,
      "location_id": null,
      "source_identifier": null,
      "source_url": null,
      "processed_at": "2019-10-16T16:05:04-04:00",
      "device_id": null,
      "phone": null,
      "customer_locale": null,
      "app_id": 755357713,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1002,
      "discount_applications": [],
      "discount_codes": [],
      "note_attributes": [],
      "payment_gateway_names": [],
      "processing_method": "",
      "checkout_id": null,
      "source_name": "755357713",
      "fulfillment_status": null,
      "tax_lines": [],
      "tags": "",
      "contact_email": null,
      "order_status_url": "https://apple.myshopify.com/690933842/orders/859d376ed1cc03345c0a1b529a693463/authenticate?key=fd82e40aa370b165bb773a4292c22327",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/1073459983",
      "line_items": [
        {
          "id": 1071823191,
          "variant_id": 447654529,
          "title": "IPod Touch 8GB",
          "quantity": 1,
          "sku": "IPOD2009BLACK",
          "variant_title": "Black",
          "vendor": "Apple",
          "fulfillment_service": "shipwire-app",
          "product_id": 921728736,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Touch 8GB - Black",
          "variant_inventory_management": "shipwire-app",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 567,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/1071823191",
          "tax_lines": []
        }
      ],
      "shipping_lines": [],
      "fulfillments": [],
      "refunds": []
    }
  ]
}

Retrieve orders that have authorized payments ready to be captured

GET /admin/api/2019-04/orders.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2019-10-16T16:05:05-04:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffeb1a3945daa1815f846f55c11e731a",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve orders last updated after 2005-07-31 15:57:11 in the EDT timezone

GET /admin/api/2019-04/orders.json?updated_at_min=2005-07-31T15:57:11-04:00
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=9f27cc8b514a93a6f6841b0d8227103a",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve all orders but show only certain properties

GET /admin/api/2019-04/orders.json?fields=created_at,id,name,total-price
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "created_at": "2008-01-10T11:00:00-05:00",
      "total_price": "598.94",
      "name": "#1001"
    }
  ]
}

Retrieve all orders after the specified ID

GET /admin/api/2019-04/orders.json?since_id=123
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=9eb05ea008a41981db32ca45d431117b",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}
GET /admin/api/2019-04/orders/#{order_id}.json
Retrieves a specific order
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve a single order

GET /admin/api/2019-04/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2008-01-10T11:00:00-05:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ae8af92349ee3e1dee8b24eef131fbea",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Get only particular fields

GET /admin/api/2019-04/orders/#{order_id}.json?fields=id,line_items,name,total_price
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "total_price": "598.94",
    "name": "#1001",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ]
  }
}
GET /admin/api/2019-04/orders/count.json
Retrieves an order count
created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00).

status

Count orders of a given status.

(default: open)
  • open: Count open orders.
  • closed: Count closed orders.
  • any: Count orders of any status.
financial_status

Count orders of a given financial status.

(default: any)
  • authorized: Count authorized orders.
  • pending: Count pending orders.
  • paid: Count paid orders.
  • refunded: Count refunded orders.
  • voided: Count voided orders.
  • any: Count orders of any financial status.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.

Count all orders

GET /admin/api/2019-04/orders/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Count orders that have authorized payments ready to be captured

GET /admin/api/2019-04/orders/count.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST /admin/api/2019-04/orders/#{order_id}/close.json
Closes an order

Close an order

POST /admin/api/2019-04/orders/#{order_id}/close.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": "2019-10-16T16:05:17-04:00",
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:17-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2e921b708a09b041a65ffb02d4d1be52",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-04/orders/#{order_id}/open.json
Re-opens a closed order

Re-open a closed order

POST /admin/api/2019-04/orders/#{order_id}/open.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:19-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f370264649269e90e395c9294bd4b358",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-04/orders/#{order_id}/cancel.json
Cancels an order. Orders that have a fulfillment object can't be canceled.
amount

The amount to refund. If set, Shopify attempts to void or refund the payment, depending on its status.

currency

The currency of the refund that's issued when the order is canceled. Required for multi-currency orders whenever the amount property is provided.

restock
deprecated

Whether to restock refunded items back to your store's inventory.

(default: false)
reason

The reason for the order cancellation. Valid values: customer, inventory, fraud, declined, and other.)

(default: other)
email

Whether to send an email to the customer notifying them of the cancellation.

(default: false)
refund

The refund transactions to perform. Required for some more complex refund situations. For more information, see the Refund API.

Cancel an order

POST /admin/api/2019-04/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2008-01-10T11:00:00-05:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=341cf1d04694165a4cd345d0b6b81954",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Cancel and refund an order using the amount property

POST /admin/api/2019-04/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "10.00",
  "currency": "USD"
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:24-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "bogus",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=382805203a96d6c29ca7600046ba6290",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361468,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:24-04:00",
      "note": null,
      "user_id": null,
      "processed_at": "2019-10-16T16:05:24-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361468",
      "refund_line_items": [
        {
          "id": 1058498313,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498314,
          "quantity": 1,
          "line_item_id": 518995019,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 518995019,
            "variant_id": 49148385,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008RED",
            "variant_title": "red",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - red",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498315,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844705,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:24-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844704,
          "processed_at": "2019-10-16T16:05:24-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844705"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

When an order has multiple refundable transactions, refunding an amount less than its net payment without a refund property fails with an error

POST /admin/api/2019-04/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "109.00",
  "currency": "USD"
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:27-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=a64beb6670f1295ff7ff08c2f06e132b",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Refund parameter required to process refund"
}

Cancel and refund an order using the refund property

POST /admin/api/2019-04/orders/#{order_id}/cancel.json
{
  "refund": {
    "note": "Customer made a mistake",
    "shipping": {
      "full_refund": true
    },
    "refund_line_items": [
      {
        "line_item_id": 466157049,
        "quantity": 1,
        "restock_type": "cancel",
        "location_id": 48752903
      }
    ],
    "transactions": [
      {
        "parent_id": 1072844710,
        "amount": "10.00",
        "kind": "refund",
        "gateway": "bogus"
      },
      {
        "parent_id": 1072844711,
        "amount": "100.00",
        "kind": "refund",
        "gateway": "gift_card"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:32-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "gift_card",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b714067bde79ce7e56beddd5c225a955",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361469,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:32-04:00",
      "note": "Customer made a mistake",
      "user_id": null,
      "processed_at": "2019-10-16T16:05:32-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361469",
      "refund_line_items": [
        {
          "id": 1058498316,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844712,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844710,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844712"
        },
        {
          "id": 1072844713,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "gift_card",
          "status": "success",
          "message": null,
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": false,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844711,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {
            "gift_card_id": 48394658,
            "gift_card_last_characters": "0d0d"
          },
          "error_code": null,
          "source_name": "755357713",
          "amount": "100.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844713"
        }
      ],
      "order_adjustments": [
        {
          "id": 1030976845,
          "order_id": 450789469,
          "refund_id": 929361469,
          "amount": "92.98",
          "tax_amount": "0.00",
          "kind": "refund_discrepancy",
          "reason": "Refund discrepancy",
          "amount_set": {
            "shop_money": {
              "amount": "92.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "92.98",
              "currency_code": "USD"
            }
          },
          "tax_amount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Canceling an order that has fulfillments fails with an error

POST /admin/api/2019-04/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:33-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2995df0cbbf011b1b9a4be120b578ba6",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": "fulfilled",
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:05:33-04:00",
      "tracking_company": "UPS",
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Cannot cancel a paid and fulfilled order"
}
POST /admin/api/2019-04/orders.json

Creates an order. By default, product inventory is not claimed.

When you create an order, you can include the following option parameters in the body of the request:

  • inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
    • bypass: Do not claim inventory.
    • decrement_ignoring_policy: Ignore the product's inventory policy and claim inventory.
    • decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
  • send_receipt: Whether to send an order confirmation to the customer.
  • send_fulfillment_receipt: Whether to send a shipping confirmation to the customer.

Create a simple order with only a product variant ID

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459985,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:35-04:00",
    "updated_at": "2019-10-16T16:05:35-04:00",
    "number": 2,
    "note": null,
    "token": "8d9822b56c8bac57b659e0356c17130f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:35-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/8d9822b56c8bac57b659e0356c17130f/authenticate?key=78077388d47f4ce5286404667593b472",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459985",
    "line_items": [
      {
        "id": 1071823193,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823193",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create a simple order, sending an order confirmation and a shipping confirmation to the customer

POST /admin/api/2019-04/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "send_receipt": true,
    "send_fulfillment_receipt": true,
    "line_items": [
      {
        "variant_id": 457924702,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459986,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:36-04:00",
    "updated_at": "2019-10-16T16:05:36-04:00",
    "number": 2,
    "note": null,
    "token": "099ade3f1a08fd25e238d8cd0c7b21cc",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:36-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/099ade3f1a08fd25e238d8cd0c7b21cc/authenticate?key=939e30cc5de654fa267acb4f84d1ce53",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459986",
    "line_items": [
      {
        "id": 1071823194,
        "variant_id": 457924702,
        "title": "IPod Nano - 8GB",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782937,
        "order_id": 1073459986,
        "status": "success",
        "created_at": "2019-10-16T16:05:36-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:05:36-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782937",
        "line_items": [
          {
            "id": 1071823194,
            "variant_id": 457924702,
            "title": "IPod Nano - 8GB",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339486,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:36-04:00",
      "updated_at": "2019-10-16T16:05:36-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459986,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:36-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339486"
    }
  }
}

Create a simple order without sending an order receipt or a fulfillment receipt

POST /admin/api/2019-04/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459987,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:37-04:00",
    "updated_at": "2019-10-16T16:05:37-04:00",
    "number": 2,
    "note": null,
    "token": "473abaf7f739a5f62e92101d68b6ba1f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:37-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/473abaf7f739a5f62e92101d68b6ba1f/authenticate?key=aba982bdcb58f9f664a65577a33a61ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459987",
    "line_items": [
      {
        "id": 1071823195,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782938,
        "order_id": 1073459987,
        "status": "pending",
        "created_at": "2019-10-16T16:05:38-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:38-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 48752903,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782938",
        "line_items": [
          {
            "id": 1071823195,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339487,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:37-04:00",
      "updated_at": "2019-10-16T16:05:38-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459987,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:38-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339487"
    }
  }
}

Create a simple order and fulfill it

POST /admin/api/2019-04/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "fulfillments": [
      {
        "location_id": 905684977
      }
    ],
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459988,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:39-04:00",
    "updated_at": "2019-10-16T16:05:39-04:00",
    "number": 2,
    "note": null,
    "token": "596f82e63339494af345c9d2c0028d1a",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:39-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/596f82e63339494af345c9d2c0028d1a/authenticate?key=f654698e272d8a900369dbe613a14b79",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459988",
    "line_items": [
      {
        "id": 1071823196,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782939,
        "order_id": 1073459988,
        "status": "pending",
        "created_at": "2019-10-16T16:05:39-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:39-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782939",
        "line_items": [
          {
            "id": 1071823196,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339488,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:39-04:00",
      "updated_at": "2019-10-16T16:05:39-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459988,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:39-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339488"
    }
  }
}

Create a comprehensive order

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Big Brown Bear Boots",
        "price": 74.99,
        "grams": "1300",
        "quantity": 3,
        "tax_lines": [
          {
            "price": 13.5,
            "rate": 0.06,
            "title": "State tax"
          }
        ]
      }
    ],
    "transactions": [
      {
        "kind": "sale",
        "status": "success",
        "amount": 238.47
      }
    ],
    "total_tax": 13.5,
    "currency": "EUR"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459989,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:40-04:00",
    "updated_at": "2019-10-16T16:05:40-04:00",
    "number": 2,
    "note": null,
    "token": "79b48501190269e07b527a38c56f4fd7",
    "gateway": "",
    "test": false,
    "total_price": "238.47",
    "subtotal_price": "224.97",
    "total_weight": 0,
    "total_tax": "13.50",
    "taxes_included": false,
    "currency": "EUR",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "224.97",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "340.54",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:40-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "13.50",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/79b48501190269e07b527a38c56f4fd7/authenticate?key=39248e7aeafbe37e41b668ee71c76d9e",
    "presentment_currency": "EUR",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459989",
    "line_items": [
      {
        "id": 1071823197,
        "variant_id": null,
        "title": "Big Brown Bear Boots",
        "quantity": 3,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Big Brown Bear Boots",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 3,
        "grams": 1300,
        "price": "74.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823197",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "13.50",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              },
              "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create an order with tax lines split across taxable line items

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459990,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:41-04:00",
    "updated_at": "2019-10-16T16:05:41-04:00",
    "number": 2,
    "note": null,
    "token": "a04a79891455ebbd7ff38c68e1d313e8",
    "gateway": "",
    "test": false,
    "total_price": "270.37",
    "subtotal_price": "255.92",
    "total_weight": 0,
    "total_tax": "14.45",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "255.92",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "270.37",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:41-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "10.20",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "10.20",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "10.20",
            "currency_code": "USD"
          }
        }
      },
      {
        "price": "4.25",
        "rate": 0.025,
        "title": "County tax",
        "price_set": {
          "shop_money": {
            "amount": "4.25",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "4.25",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/a04a79891455ebbd7ff38c68e1d313e8/authenticate?key=c1b2fe9403c190ac3b7a2cbd6d0ec839",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "270.37",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "270.37",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "14.45",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "14.45",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459990",
    "line_items": [
      {
        "id": 1071823198,
        "variant_id": null,
        "title": "Red Leather Coat",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Red Leather Coat",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 1700,
        "price": "129.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "129.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "129.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823198",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "7.81",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "7.81",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "7.81",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "3.26",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "3.26",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.26",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 1071823199,
        "variant_id": null,
        "title": "Blue Suede Shoes",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": false,
        "gift_card": false,
        "name": "Blue Suede Shoes",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 750,
        "price": "85.95",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "85.95",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "85.95",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823199",
        "tax_lines": []
      },
      {
        "id": 1071823200,
        "variant_id": null,
        "title": "Raspberry Beret",
        "quantity": 2,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Raspberry Beret",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 2,
        "grams": 320,
        "price": "19.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "19.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "19.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823200",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "2.39",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "2.39",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "2.39",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "0.99",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "0.99",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.99",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Creating an order with tax lines both on line items and on the order fails and returns an error

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Clicky Keyboard",
        "price": 99.99,
        "grams": "600",
        "quantity": 1,
        "tax_lines": [
          {
            "price": 1.0,
            "rate": 0.01,
            "title": "Keyboard tax"
          }
        ]
      }
    ],
    "tax_lines": [
      {
        "price": 6.0,
        "rate": 0.06,
        "title": "State tax"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "order": [
      "Tax lines must be associated with either order or line item but not both"
    ]
  }
}

Create a pending order with an existing customer

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "id": 207119551
    },
    "financial_status": "pending"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459991,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:43-04:00",
    "updated_at": "2019-10-16T16:05:43-04:00",
    "number": 2,
    "note": null,
    "token": "f08815fc24c65fed5b3fbf254cb3a172",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "pending",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:43-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/f08815fc24c65fed5b3fbf254cb3a172/authenticate?key=c662919911dd8c19ddca21c9d1cccebf",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459991",
    "line_items": [
      {
        "id": 1071823201,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823201",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:05:43-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 2,
      "state": "disabled",
      "total_spent": "398.65",
      "last_order_id": 1073459991,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Create a partially paid order with a new customer and addresses

POST /admin/api/2019-04/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "first_name": "Paul",
      "last_name": "Norman",
      "email": "paul.norman@example.com"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "email": "jane@example.com",
    "transactions": [
      {
        "kind": "authorization",
        "status": "success",
        "amount": 50.0
      }
    ],
    "financial_status": "partially_paid"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459992,
    "email": "jane@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:44-04:00",
    "updated_at": "2019-10-16T16:05:44-04:00",
    "number": 2,
    "note": null,
    "token": "e925c8aed256267e9476ceb5b18477ca",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:44-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "jane@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/e925c8aed256267e9476ceb5b18477ca/authenticate?key=7e1d0cf8e8071dacaf924b3e3f6cfc5a",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459992",
    "line_items": [
      {
        "id": 1071823202,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823202",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "billing_address": {
      "first_name": "John",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "John Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "shipping_address": {
      "first_name": "Jane",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "Jane Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 1073339489,
      "email": "paul.norman@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:44-04:00",
      "updated_at": "2019-10-16T16:05:44-04:00",
      "first_name": "John",
      "last_name": "Smith",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459992,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:44-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339489",
      "default_address": {
        "id": 1053317336,
        "customer_id": 1073339489,
        "first_name": "Jane",
        "last_name": "Smith",
        "company": null,
        "address1": "123 Fake Street",
        "address2": null,
        "city": "Fakecity",
        "province": "Ontario",
        "country": "Canada",
        "zip": "K2P 1L4",
        "phone": "777-777-7777",
        "name": "Jane Smith",
        "province_code": "ON",
        "country_code": "CA",
        "country_name": "Canada",
        "default": true
      }
    }
  }
}
PUT /admin/api/2019-04/orders/#{order_id}.json
Updates an order

Add a note to order

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note": "Customer contacted us about a custom engraving on this iPod"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:45-04:00",
    "number": 1,
    "note": "Customer contacted us about a custom engraving on this iPod",
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=8155cfa3bbceabbb1d0edef7b195dd64",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add note attributes to an order

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:46-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=15010976f579ace96dd8112e57164c66",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's email address

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:47-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "a-different@email.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=7c1a0dd8ce96d5f955a323ac1373116f",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's phone number

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "phone": "+15145556677"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:48-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+15145556677",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b9aa533284a9a714082f46efa945d1aa",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change whether the buyer accepts marketing

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "buyer_accepts_marketing": true
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:49-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": true,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffda8ed25578813749d8dd508c787062",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add a metafield to an order

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:50-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0aca457a2b3b052c74d6319757af3678",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Update the shipping address of an order

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "shipping_address": {
      "address1": "123 Ship Street",
      "city": "Shipsville"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:51-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ef6881713147de7c5275468ecce51482",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "123 Ship Street",
      "phone": "555-625-1199",
      "city": "Shipsville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Remove the customer from an order

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "customer": null
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f26ab2ae733ac41257b8627419d758ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    }
  }
}

Update an order's tags

PUT /admin/api/2019-04/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "tags": "External, Inbound, Outbound"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "External, Inbound, Outbound",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=bc254a43d3744cdfa1ead8a308a26b8c",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
DELETE /admin/api/2019-04/orders/#{order_id}.json
Deletes an order. Orders that interact with an online gateway can't be deleted.

Delete an order

DELETE /admin/api/2019-04/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
}
Version 2019-07

An order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provide an email address or phone number, billing address and payment information.

Orders can be created through the API, but no payment information will be collected, and no transaction performed. You can mark the order with any payment status.

You can also allow merchants to create orders manually by using the DraftOrder resource.

Caution

You can't use the Order resource to create a new checkout for an individual store. To create a checkout, you need to use the Checkout API, or an SDK powered by the Storefront API, such as the JavaScript Buy SDK, iOS Buy SDK, or Android Buy SDK.

Caution

As of June 6th, 2018, only the last 60 days' worth of orders from a store will be accessible from the Order resource by default. If you want to access older orders, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders scope to your app along with read_orders or write_orders. Private apps are not affected by this change and are automatically granted the scope.

After an order is created, you can change only a few of its attributes using the API. You cannot change the items or the quantities in an order.

You can also add metafields to the Order resource.

What you can do with Order

The Shopify API lets you do the following with the Order resource. More detailed versions of these general actions may be available:

Order properties

app_id
read-only
"app_id": 1966818

The ID of the app that created the order.

billing_address
"billing_address": {
  "address1": "2259 Park Ct",
  "address2": "Apartment 5",
  "city": "Drayton Valley",
  "company": null,
  "country": "Canada",
  "first_name": "Christopher",
  "last_name": "Gorski",
  "phone": "(555)555-5555",
  "province": "Alberta",
  "zip": "T0E 0M0",
  "name": "Christopher Gorski",
  "province_code": "AB",
  "country_code": "CA",
  "latitude": "45.41634",
  "longitude": "-75.6868"
}

The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. It has the following properties:

  • address1: The street address of the billing address.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city, town, or village of the billing address.
  • company: The company of the person associated with the billing address.
  • country: The name of the country of the billing address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the billing address.
  • first_name: The first name of the person associated with the payment method.
  • last_name: The last name of the person associated with the payment method.
  • latitude: The latitude of the billing address.
  • longitude: The longitude of the billing address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the billing address.
  • province: The name of the region (province, state, prefecture, …) of the billing address.
  • province_code: The two-letter abbreviation of the region of the billing address.
  • zip: The postal code (zip, postcode, Eircode, …) of the billing address.
browser_ip
read-only
"browser_ip": "216.191.105.146"

The IP address of the browser used by the customer when they placed the order.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer consented to receive email updates from the shop.

cancel_reason
"cancel_reason": "customer"

The reason why the order was canceled. Valid values:

  • customer: The customer canceled the order.
  • fraud: The order was fraudulent.
  • inventory: Items in the order were not in inventory.
  • declined: The payment was declined.
  • other: A reason not in this list.
cancelled_at
read-only
"cancelled_at": null

The date and time ( ISO 8601 format) when the order was canceled.

cart_token
read-only
"cart_token": "68778783ad298f1c80c3bafcddeea"

The ID of the cart that's associated with the order.

client_details
read-only
"client_details": {
  "accept_language": "en-US,en;q=0.9",
  "browser_height": 1320,
  "browser_ip": "216.191.105.146",
  "browser_width": 1280,
  "session_hash": "9ad4d1f4e6a8977b9dd98eed1e477643",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36"
}

Information about the browser that the customer used when they placed their order:

  • accept_language: The languages and locales that the browser understands.
  • browser_height: The browser screen height in pixels, if available.
  • browser_ip: The browser IP address.
  • browser_width: The browser screen width in pixels, if available.
  • session_hash: A hash of the session.
  • user_agent: Details of the browsing client, including software and operating versions.
closed_at
read-only
"closed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the order was closed.

created_at
read-only
"created_at": "2008-01-10T11:00:00-05:00"

The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the shop currency.

customer
"customer": {
  "id": 207119551,
  "email": "bob.norman@hostmail.com",
  "accepts_marketing": false,
  "created_at": "2012-03-13T16:09:55-04:00",
  "updated_at": "2012-03-13T16:09:55-04:00",
  "first_name": "Bob",
  "last_name": "Norman",
  "orders_count": "1",
  "state": "disabled",
  "total_spent": "0.00",
  "last_order_id": 450789469,
  "note": null,
  "verified_email": true,
  "multipass_identifier": null,
  "tax_exempt": false,
  "tax_exemptions": {},
  "phone": "+13125551212",
  "tags": "loyal",
  "last_order_name": "#1001",
  "currency": "USD",
  "addresses": {},
  "admin_graphql_api_id": "gid://shopify/Customer/207119551",
  "default_address": {}
}

Information about the customer. The order might not have a customer and apps should not depend on the existence of a customer object. This value might be null if the order was created through Shopify POS. For more information about the customer object, see the Customer resource.

customer_locale
read-only
"customer_locale": "en-CA"

The two or three-letter language code, optionally followed by a region modifier.

discount_applications
read-only
"discount_applications": [
  {
    "type": "manual",
    "title": "custom discount",
    "description": "customer deserved it",
    "value": "2.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "line_item"
  },
  {
    "type": "script",
    "description": "my scripted discount",
    "value": "5.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "shipping_line"
  },
  {
    "type": "discount_code",
    "code": "SUMMERSALE",
    "value": "10.0",
    "value_type": "fixed_amount",
    "allocation_method": "across",
    "target_selection": "all",
    "target_type": "line_item"
  }
]

An ordered list of stacked discount applications.

The discount_applications property includes 3 types: discount_code, manual, and script. All 3 types share a common structure and have some type specific attributes.

  • allocation_method: The method by which the discount application value has been allocated to entitled lines. Valid values:
    • across: The value is spread across all entitled lines.
    • each: The value is applied onto every entitled line.
    • one: The value is applied onto a single line.
  • code: The discount code that was used to apply the discount. Available only for discount code applications.
  • description: The description of the discount application, as defined by the merchant or the Shopify Script. Available only for manual and script discount applications.
  • target_selection: The lines on the order, of the type defined by target_type, that the discount is allocated over. Valid values:
    • all: The discount is allocated onto all lines,
    • entitled: The discount is allocated only onto lines it is entitled for.
    • explicit: The discount is allocated onto explicitly selected lines.
  • target_type: The type of line on the order that the discount is applicable on. Valid values:
    • line_item: The discount applies to line items.
    • shipping_line: The discount applies to shipping lines.
  • title: The title of the discount application, as defined by the merchant. Available only for manual discount applications.
  • type: The discount application type. Valid values:
    • manual: The discount was manually applied by the merchant (for example, by using an app or creating a draft order).
    • script: The discount was applied by a Shopify Script.
    • discount_code: The discount was applied by a discount code.
  • value: The value of the discount application as a decimal. This represents the intention of the discount application. For example, if the intent was to apply a 20% discount, then the value will be 20.0. If the intent was to apply a $15 discount, then the value will be 15.0.
  • value_type: The type of the value. Valid values:
    • fixed_amount: A fixed amount discount value in the currency of the order.
    • percentage: A percentage discount value.
discount_codes
"discount_codes": [
  {
    "code": "SPRING30",
    "amount": "30.00",
    "type": "fixed_amount"
  }
]

A list of discount codes to apply to the order. Each discount code object includes the following fields:

  • amount: The value of the discount to be deducted from the order total. The type field determines how this value is calculated. After an order is created, this field returns the calculated amount.
  • code: The discount code.
  • type: The type of discount. Default value: fixed_amount. Valid values:
    • fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied.
    • percentage: Applies a discount of amount as a percentage of the order total.
    • shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30.
email
"email": "bob.norman@hostmail.com"

The customer's email address.

financial_status
"financial_status": "authorized"

The status of payments associated with the order. Can only be set when the order is created. Valid values:

  • pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully.
  • authorized: The payments have been authorized.
  • partially_paid: The order have been partially paid.
  • paid: The payments have been paid.
  • partially_refunded: The payments have been partially refunded.
  • refunded: The payments have been refunded.
  • voided: The payments have been voided.
fulfillments
"fulfillments": [
  {
    "created_at": "2012-03-13T16:09:54-04:00",
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "tracking_company": null,
    "tracking_number": "1Z2345",
    "updated_at": "2012-05-01T14:22:25-04:00"
  }
]

A list of fulfillments associated with the order. For more information, see the Fulfillment API.

fulfillment_status
"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
gateway
deprecated
"gateway": "shopify_payments"

The payment gateway used.

Use the Transaction resource instead.

id
read-only
"id": 450789469

The ID of the order, used for API purposes. This is different from the order_number property, which is the ID used by the shop owner and customer.'

landing_site
read-only
"landing_site": "http://www.example.com?source=abc"

The URL for the page where the buyer landed when they entered the shop.

line_items
required
"line_items": [
  {
    "fulfillable_quantity": 1,
    "fulfillment_service": "amazon",
    "fulfillment_status": "fulfilled",
    "grams": 500,
    "id": 669751112,
    "price": "199.99",
    "product_id": 7513594,
    "quantity": 1,
    "requires_shipping": true,
    "sku": "IPOD-342-N",
    "title": "IPod Nano",
    "variant_id": 4264112,
    "variant_title": "Pink",
    "vendor": "Apple",
    "name": "IPod Nano - Pink",
    "gift_card": false,
    "price_set": {
      "shop_money": {
        "amount": "199.99",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "173.30",
        "currency_code": "EUR"
      }
    },
    "properties": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday Mom!"
      }
    ],
    "taxable": true,
    "tax_lines": [
      {
        "title": "HST",
        "price": "25.81",
        "price_set": {
          "shop_money": {
            "amount": "25.81",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "20.15",
            "currency_code": "EUR"
          }
        },
        "rate": 0.13
      }
    ],
    "total_discount": "5.00",
    "total_discount_set": {
      "shop_money": {
        "amount": "5.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "4.30",
        "currency_code": "EUR"
      }
    },
    "discount_allocations": [
      {
        "amount": "5.00",
        "discount_application_index": 2,
        "amount_set": {
          "shop_money": {
            "amount": "5.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "3.96",
            "currency_code": "EUR"
          }
        }
      }
    ]
  }
]

A list of line item objects, each containing information about an item in the order. Each object has the following properties:

  • fulfillable_quantity: The amount available to fulfill, calculated as follows:
    quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity
  • fulfillment_service: The service provider that's fulfilling the item. Valid values: manual, or the name of the provider, such as amazon or shipwire.
  • fulfillment_status: How far along an order is in terms line items fulfilled. Valid values: null, fulfilled, partial, and not_eligible.
  • grams: The weight of the item in grams.
  • id: The ID of the line item.
  • price: The price of the item before discounts have been applied in the shop currency.
  • price_set: The price of the line item in shop and presentment currencies.
  • product_id: The ID of the product that the line item belongs to. Can be null if the original product associated with the order is deleted at a later date.
  • quantity: The number of items that were purchased.
  • requires_shipping: Whether the item requires shipping.
  • sku: The item's SKU (stock keeping unit).
  • title: The title of the product.
  • variant_id: The ID of the product variant.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.
  • name: The name of the product variant.
  • gift_card: Whether the item is a gift card. If true, then the item is not taxed or considered for shipping charges.
  • properties: An array of custom information for the item that has been added to the cart. Often used to provide product customization options. For more information, see Get customization information for products with line item properties.
  • taxable: Whether the item was taxable.
  • tax_lines: A list of tax line objects, each of which details a tax applied to the item.
    • title: The name of the tax.
    • price: The amount added to the order for this tax in the shop currency.
    • price_set: The amount added to the order for this tax in shop and presentment currencies.
    • rate: The tax rate applied to the order to calculate the tax price.
  • tip_payment_gateway: The payment gateway used to tender the tip, such as shopify_payments. Present only on tips.
  • tip_payment_method: The payment method used to tender the tip, such as Visa. Present only on tips.
  • total_discount: The total discount amount applied to this line item in the shop currency. This value is not subtracted in the line item price.
  • total_discount_set: The total discount applied to the line item in shop and presentment currencies.
  • discount_allocations: An ordered list of amounts allocated by discount applications. Each discount allocation is associated to a particular discount application.
    • amount: The discount amount allocated to the line in the shop currency.
    • discount_application_index: The index of the associated discount application in the order's discount_applications list.
    • amount_set: The discount amount allocated to the line item in shop and presentment currencies.
location_id
"location_id": 49202758

The ID of the physical location where the order was processed.

name
read-only
"name": "#1001"

The order name as represented by a number. Must start with #.

note
"note": "Customer changed their mind."

An optional note that a shop owner can attach to the order.

note_attributes
"note_attributes": [
  {
    "name": "custom name",
    "value": "custom value"
  }
]

Extra information that is added to the order. Appears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.

number
read-only
"number": 1000

For internal use only. An ID unique to the shop. Numbers are sequential and start at 1000.

order_number
read-only
"order_number": 1001

The ID of the order used by the shop owner and customer. This is different from the id property, which is the ID of the order used by the API.

payment_details
deprecated
"payment_details": {
  "avs_result_code": "Y",
  "credit_card_bin": "453600",
  "cvv_result_code": "M",
  "credit_card_number": "•••• •••• •••• 4242",
  "credit_card_company": "Visa"
}

An object containing information about the payment. It has the following properties:

  • avs_result_code: The response code from the address verification system (AVS). The code is a single letter. See this chart for the codes and their definitions.
  • credit_card_bin: The issuer identification number (IIN), formerly known as the bank identification number (BIN), of the customer's credit card. This is made up of the first few digits of the credit card number.
  • credit_card_company: The name of the company who issued the customer's credit card.
  • credit_card_number: The customer's credit card number, with most of the leading digits redacted.
  • cvv_result_code: The response code from the credit card company indicating whether the customer entered the card security code (card verification value) correctly. The code is a single letter or empty string. See this chart for the codes and their definitions.

Use the Transaction resource instead.

payment_gateway_names
read-only
"payment_gateway_names": [
  "authorize_net",
  "Cash on Delivery (COD)"
]

The list of payment gateways used for the order.

phone
"phone": "+557734881234"

The customer's phone number for receiving SMS notifications.

presentment_currency
"presentment_currency": "CAD"

The presentment currency that was used to display prices to the customer.

processed_at
"processed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created.

processing_method
read-only
"processing_method": "direct"

How the payment was processed. It has the following valid values:

referring_site
"referring_site": "http://www.anexample.com"

The website where the customer clicked a link to the shop.

refunds
read-only
"refunds": [
  {
    "id": 18423447608,
    "order_id": 394481795128,
    "created_at": "2018-03-06T09:35:37-05:00",
    "note": null,
    "user_id": null,
    "processed_at": "2018-03-06T09:35:37-05:00",
    "refund_line_items": [],
    "transactions": [],
    "order_adjustments": []
  }
]

A list of refunds applied to the order. For more information, see the Refund API.

shipping_address
"shipping_address": {
  "address1": "123 Amoebobacterieae St",
  "address2": "",
  "city": "Ottawa",
  "company": null,
  "country": "Canada",
  "first_name": "Bob",
  "last_name": "Bobsen",
  "latitude": "45.41634",
  "longitude": "-75.6868",
  "phone": "555-625-1199",
  "province": "Ontario",
  "zip": "K2P0V6",
  "name": "Bob Bobsen",
  "country_code": "CA",
  "province_code": "ON"
}

The mailing address to where the order will be shipped. This address is optional and will not be available on orders that do not require shipping. It has the following properties:

  • address1: The street address of the shipping address.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city, town, or village of the shipping address.
  • company: The company of the person associated with the shipping address.
  • country: The name of the country of the shipping address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • latitude: The latitude of the shipping address.
  • longitude: The longitude of the shipping address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the shipping address.
  • province: The name of the region (province, state, prefecture, …) of the shipping address.
  • province_code: The two-letter abbreviation of the region of the shipping address.
  • zip: The postal code (zip, postcode, Eircode, …) of the shipping address.
shipping_lines
"shipping_lines": [
  {
    "code": "INT.TP",
    "price": "4.00",
    "price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "discounted_price": "4.00",
    "discounted_price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "source": "canada_post",
    "title": "Small Packet International Air",
    "tax_lines": [],
    "carrier_identifier": "third_party_carrier_identifier",
    "requested_fulfillment_service_id": "third_party_fulfillment_service_id"
  }
]

An array of objects, each of which details a shipping method used. Each object has the following properties:

  • code: A reference to the shipping method.
  • discounted_price: The price of the shipping method after line-level discounts have been applied. Doesn't reflect cart-level or order-level discounts.
  • discounted_price_set: The price of the shipping method in both shop and presentment currencies after line-level discounts have been applied.
  • price: The price of this shipping method in the shop currency. Can't be negative.
  • price_set: The price of the shipping method in shop and presentment currencies.
  • source: The source of the shipping method.
  • title: The title of the shipping method.
  • tax_lines: A list of tax line objects, each of which details a tax applicable to this shipping line.
  • carrier_identifier: A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
  • requested_fulfillment_service_id: A reference to the fulfillment service that is being requested for the shipping method. Present if the shipping method requires processing by a third party fulfillment service; null otherwise.
source_name
"source_name": "web"

Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, shopify_draft_order, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value of your app's ID.

subtotal_price
"subtotal_price": 398.0

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

subtotal_price_set
"subtotal_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The subtotal of the order in shop and presentment currencies.

tags
"tags": "imported"

Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length.

tax_lines
"tax_lines": [
  {
    "price": 11.94,
    "rate": 0.06,
    "title": "State Tax"
  }
]

An array of tax line objects, each of which details a tax applicable to the order. Each object has the following properties:

  • price: The amount of tax to be charged in the shop currency.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.
When creating an order through the API, tax lines can be specified on the order or the line items but not both. Tax lines specified on the order are split across the taxable line items in the created order.
taxes_included
"taxes_included": false

Whether taxes are included in the order subtotal.

test
"test": true

Whether this is a test order.

token
read-only
"token": "b1946ac92492d2347c6235b4d2611184"

A unique token for the order.

total_discounts
"total_discounts": "0.00"

The total discounts applied to the price of the order in the shop currency.

total_discounts_set
"total_discounts_set": {
  "shop_money": {
    "amount": "0.00",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "0.00",
    "currency_code": "EUR"
  }
}

The total discounts applied to the price of the order in shop and presentment currencies.

total_line_items_price
"total_line_items_price": "398.00"

The sum of all line item prices in the shop currency.

total_line_items_price_set
"total_line_items_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The total of all line item prices in shop and presentment currencies.

total_price
"total_price": "409.94"

The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive.

total_price_set
"total_price_set": {
  "shop_money": {
    "amount": "164.86",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "105.31",
    "currency_code": "EUR"
  }
}

The total price of the order in shop and presentment currencies.

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the order in th shop currency. Must be positive).

total_tax_set
"total_tax_set": {
  "shop_money": {
    "amount": "18.87",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "11.82",
    "currency_code": "EUR"
  }
}

The total tax applied to the order in shop and presentment currencies.

total_tip_received
"total_tip_received": "4.87"

The sum of all the tips in the order in the shop currency.

total_weight
"total_weight": 300

The sum of all line item weights in grams.

updated_at
read-only
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format) when the order was last modified.

Filtering orders by updated_at is not an effective method for fetching orders because its value can change when no visible fields of an order have been updated. Use the Webhook and Event APIs to subscribe to order events instead.

user_id
"user_id": 31522279

The ID of the user logged into Shopify POS who processed the order, if applicable.

order_status_url
read-only
"order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35"

The URL pointing to the order status web page, if applicable.

Endpoints

GET /admin/api/2019-07/orders.json
Retrieves a list of orders.
ids

Retrieve only orders specified by a comma-separated list of order IDs.

limit

The maximum number of results to show on a page.

(default: 50, maximum: 250)
page
deprecated

The page of results to show.

(default: 1)
since_id

Show orders after the specified ID.

created_at_min

Show orders created at or after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Show orders created at or before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Show orders last updated at or after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Show orders last updated at or before date (format: 2014-04-25T16:15:47-04:00).

processed_at_min

Show orders imported at or after date (format: 2014-04-25T16:15:47-04:00).

processed_at_max

Show orders imported at or before date (format: 2014-04-25T16:15:47-04:00).

attribution_app_id

Show orders attributed to a certain app, specified by the app ID. Set as current to show orders for the app currently consuming the API.

status

Filter orders by their status.

(default: open)
  • open: Show only open orders.
  • closed: Show only closed orders.
  • cancelled: Show only canceled orders.
  • any: Show orders of any status, including archived orders.
financial_status

Filter orders by their financial status.

(default: any)
  • authorized: Show only authorized orders
  • pending: Show only pending orders
  • paid: Show only paid orders
  • partially_paid: Show only partially paid orders
  • refunded: Show only refunded orders
  • voided: Show only voided orders
  • partially_refunded: Show only partially refunded orders
  • any: Show orders of any financial status.
  • unpaid: Show authorized and partially paid orders.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve all orders

GET /admin/api/2019-07/orders.json
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=cdfb71699e69d7ac5f1de2026e8f331e",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve specific orders

GET /admin/api/2019-07/orders.json?ids=1073459983
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 1073459983,
      "email": "",
      "closed_at": null,
      "created_at": "2019-10-16T16:05:04-04:00",
      "updated_at": "2019-10-16T16:05:04-04:00",
      "number": 2,
      "note": null,
      "token": "859d376ed1cc03345c0a1b529a693463",
      "gateway": "",
      "test": false,
      "total_price": "199.00",
      "subtotal_price": "199.00",
      "total_weight": 0,
      "total_tax": "0.00",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "paid",
      "confirmed": true,
      "total_discounts": "0.00",
      "total_line_items_price": "199.00",
      "cart_token": null,
      "buyer_accepts_marketing": false,
      "name": "#1002",
      "referring_site": null,
      "landing_site": null,
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "199.00",
      "checkout_token": null,
      "reference": null,
      "user_id": null,
      "location_id": null,
      "source_identifier": null,
      "source_url": null,
      "processed_at": "2019-10-16T16:05:04-04:00",
      "device_id": null,
      "phone": null,
      "customer_locale": null,
      "app_id": 755357713,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1002,
      "discount_applications": [],
      "discount_codes": [],
      "note_attributes": [],
      "payment_gateway_names": [],
      "processing_method": "",
      "checkout_id": null,
      "source_name": "755357713",
      "fulfillment_status": null,
      "tax_lines": [],
      "tags": "",
      "contact_email": null,
      "order_status_url": "https://apple.myshopify.com/690933842/orders/859d376ed1cc03345c0a1b529a693463/authenticate?key=fd82e40aa370b165bb773a4292c22327",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/1073459983",
      "line_items": [
        {
          "id": 1071823191,
          "variant_id": 447654529,
          "title": "IPod Touch 8GB",
          "quantity": 1,
          "sku": "IPOD2009BLACK",
          "variant_title": "Black",
          "vendor": "Apple",
          "fulfillment_service": "shipwire-app",
          "product_id": 921728736,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Touch 8GB - Black",
          "variant_inventory_management": "shipwire-app",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 567,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/1071823191",
          "tax_lines": []
        }
      ],
      "shipping_lines": [],
      "fulfillments": [],
      "refunds": []
    }
  ]
}

Retrieve orders that have authorized payments ready to be captured

GET /admin/api/2019-07/orders.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2019-10-16T16:05:05-04:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffeb1a3945daa1815f846f55c11e731a",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve orders last updated after 2005-07-31 15:57:11 in the EDT timezone

GET /admin/api/2019-07/orders.json?updated_at_min=2005-07-31T15:57:11-04:00
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=9f27cc8b514a93a6f6841b0d8227103a",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve all orders but show only certain properties

GET /admin/api/2019-07/orders.json?fields=created_at,id,name,total-price
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "created_at": "2008-01-10T11:00:00-05:00",
      "total_price": "598.94",
      "name": "#1001"
    }
  ]
}

Retrieve all orders after the specified ID

GET /admin/api/2019-07/orders.json?since_id=123
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=9eb05ea008a41981db32ca45d431117b",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}
GET /admin/api/2019-07/orders/#{order_id}.json
Retrieves a specific order
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve a single order

GET /admin/api/2019-07/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2008-01-10T11:00:00-05:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ae8af92349ee3e1dee8b24eef131fbea",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Get only particular fields

GET /admin/api/2019-07/orders/#{order_id}.json?fields=id,line_items,name,total_price
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "total_price": "598.94",
    "name": "#1001",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ]
  }
}
GET /admin/api/2019-07/orders/count.json
Retrieves an order count
created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00).

status

Count orders of a given status.

(default: open)
  • open: Count open orders.
  • closed: Count closed orders.
  • any: Count orders of any status.
financial_status

Count orders of a given financial status.

(default: any)
  • authorized: Count authorized orders.
  • pending: Count pending orders.
  • paid: Count paid orders.
  • refunded: Count refunded orders.
  • voided: Count voided orders.
  • any: Count orders of any financial status.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.

Count all orders

GET /admin/api/2019-07/orders/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Count orders that have authorized payments ready to be captured

GET /admin/api/2019-07/orders/count.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST /admin/api/2019-07/orders/#{order_id}/close.json
Closes an order

Close an order

POST /admin/api/2019-07/orders/#{order_id}/close.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": "2019-10-16T16:05:17-04:00",
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:17-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2e921b708a09b041a65ffb02d4d1be52",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-07/orders/#{order_id}/open.json
Re-opens a closed order

Re-open a closed order

POST /admin/api/2019-07/orders/#{order_id}/open.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:19-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f370264649269e90e395c9294bd4b358",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-07/orders/#{order_id}/cancel.json
Cancels an order. Orders that have a fulfillment object can't be canceled.
amount

The amount to refund. If set, Shopify attempts to void or refund the payment, depending on its status.

currency

The currency of the refund that's issued when the order is canceled. Required for multi-currency orders whenever the amount property is provided.

restock
deprecated

Whether to restock refunded items back to your store's inventory.

(default: false)
reason

The reason for the order cancellation. Valid values: customer, inventory, fraud, declined, and other.)

(default: other)
email

Whether to send an email to the customer notifying them of the cancellation.

(default: false)
refund

The refund transactions to perform. Required for some more complex refund situations. For more information, see the Refund API.

Cancel an order

POST /admin/api/2019-07/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2008-01-10T11:00:00-05:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=341cf1d04694165a4cd345d0b6b81954",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Cancel and refund an order using the amount property

POST /admin/api/2019-07/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "10.00",
  "currency": "USD"
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:24-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "bogus",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=382805203a96d6c29ca7600046ba6290",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361468,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:24-04:00",
      "note": null,
      "user_id": null,
      "processed_at": "2019-10-16T16:05:24-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361468",
      "refund_line_items": [
        {
          "id": 1058498313,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498314,
          "quantity": 1,
          "line_item_id": 518995019,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 518995019,
            "variant_id": 49148385,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008RED",
            "variant_title": "red",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - red",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498315,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844705,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:24-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844704,
          "processed_at": "2019-10-16T16:05:24-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844705"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

When an order has multiple refundable transactions, refunding an amount less than its net payment without a refund property fails with an error

POST /admin/api/2019-07/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "109.00",
  "currency": "USD"
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:27-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=a64beb6670f1295ff7ff08c2f06e132b",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Refund parameter required to process refund"
}

Cancel and refund an order using the refund property

POST /admin/api/2019-07/orders/#{order_id}/cancel.json
{
  "refund": {
    "note": "Customer made a mistake",
    "shipping": {
      "full_refund": true
    },
    "refund_line_items": [
      {
        "line_item_id": 466157049,
        "quantity": 1,
        "restock_type": "cancel",
        "location_id": 48752903
      }
    ],
    "transactions": [
      {
        "parent_id": 1072844710,
        "amount": "10.00",
        "kind": "refund",
        "gateway": "bogus"
      },
      {
        "parent_id": 1072844711,
        "amount": "100.00",
        "kind": "refund",
        "gateway": "gift_card"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:32-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "gift_card",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b714067bde79ce7e56beddd5c225a955",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361469,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:32-04:00",
      "note": "Customer made a mistake",
      "user_id": null,
      "processed_at": "2019-10-16T16:05:32-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361469",
      "refund_line_items": [
        {
          "id": 1058498316,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844712,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844710,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844712"
        },
        {
          "id": 1072844713,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "gift_card",
          "status": "success",
          "message": null,
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": false,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844711,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {
            "gift_card_id": 48394658,
            "gift_card_last_characters": "0d0d"
          },
          "error_code": null,
          "source_name": "755357713",
          "amount": "100.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844713"
        }
      ],
      "order_adjustments": [
        {
          "id": 1030976845,
          "order_id": 450789469,
          "refund_id": 929361469,
          "amount": "92.98",
          "tax_amount": "0.00",
          "kind": "refund_discrepancy",
          "reason": "Refund discrepancy",
          "amount_set": {
            "shop_money": {
              "amount": "92.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "92.98",
              "currency_code": "USD"
            }
          },
          "tax_amount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Canceling an order that has fulfillments fails with an error

POST /admin/api/2019-07/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:33-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2995df0cbbf011b1b9a4be120b578ba6",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": "fulfilled",
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:05:33-04:00",
      "tracking_company": "UPS",
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Cannot cancel a paid and fulfilled order"
}
POST /admin/api/2019-07/orders.json

Creates an order. By default, product inventory is not claimed.

When you create an order, you can include the following option parameters in the body of the request:

  • inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
    • bypass: Do not claim inventory.
    • decrement_ignoring_policy: Ignore the product's inventory policy and claim inventory.
    • decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
  • send_receipt: Whether to send an order confirmation to the customer.
  • send_fulfillment_receipt: Whether to send a shipping confirmation to the customer.

Create a simple order with only a product variant ID

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459985,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:35-04:00",
    "updated_at": "2019-10-16T16:05:35-04:00",
    "number": 2,
    "note": null,
    "token": "8d9822b56c8bac57b659e0356c17130f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:35-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/8d9822b56c8bac57b659e0356c17130f/authenticate?key=78077388d47f4ce5286404667593b472",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459985",
    "line_items": [
      {
        "id": 1071823193,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823193",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create a simple order, sending an order confirmation and a shipping confirmation to the customer

POST /admin/api/2019-07/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "send_receipt": true,
    "send_fulfillment_receipt": true,
    "line_items": [
      {
        "variant_id": 457924702,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459986,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:36-04:00",
    "updated_at": "2019-10-16T16:05:36-04:00",
    "number": 2,
    "note": null,
    "token": "099ade3f1a08fd25e238d8cd0c7b21cc",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:36-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/099ade3f1a08fd25e238d8cd0c7b21cc/authenticate?key=939e30cc5de654fa267acb4f84d1ce53",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459986",
    "line_items": [
      {
        "id": 1071823194,
        "variant_id": 457924702,
        "title": "IPod Nano - 8GB",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782937,
        "order_id": 1073459986,
        "status": "success",
        "created_at": "2019-10-16T16:05:36-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:05:36-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782937",
        "line_items": [
          {
            "id": 1071823194,
            "variant_id": 457924702,
            "title": "IPod Nano - 8GB",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339486,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:36-04:00",
      "updated_at": "2019-10-16T16:05:36-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459986,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:36-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339486"
    }
  }
}

Create a simple order without sending an order receipt or a fulfillment receipt

POST /admin/api/2019-07/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459987,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:37-04:00",
    "updated_at": "2019-10-16T16:05:37-04:00",
    "number": 2,
    "note": null,
    "token": "473abaf7f739a5f62e92101d68b6ba1f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:37-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/473abaf7f739a5f62e92101d68b6ba1f/authenticate?key=aba982bdcb58f9f664a65577a33a61ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459987",
    "line_items": [
      {
        "id": 1071823195,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782938,
        "order_id": 1073459987,
        "status": "pending",
        "created_at": "2019-10-16T16:05:38-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:38-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 48752903,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782938",
        "line_items": [
          {
            "id": 1071823195,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339487,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:37-04:00",
      "updated_at": "2019-10-16T16:05:38-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459987,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:38-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339487"
    }
  }
}

Create a simple order and fulfill it

POST /admin/api/2019-07/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "fulfillments": [
      {
        "location_id": 905684977
      }
    ],
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459988,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:39-04:00",
    "updated_at": "2019-10-16T16:05:39-04:00",
    "number": 2,
    "note": null,
    "token": "596f82e63339494af345c9d2c0028d1a",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:39-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/596f82e63339494af345c9d2c0028d1a/authenticate?key=f654698e272d8a900369dbe613a14b79",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459988",
    "line_items": [
      {
        "id": 1071823196,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782939,
        "order_id": 1073459988,
        "status": "pending",
        "created_at": "2019-10-16T16:05:39-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:39-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782939",
        "line_items": [
          {
            "id": 1071823196,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339488,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:39-04:00",
      "updated_at": "2019-10-16T16:05:39-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459988,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:39-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339488"
    }
  }
}

Create a comprehensive order

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Big Brown Bear Boots",
        "price": 74.99,
        "grams": "1300",
        "quantity": 3,
        "tax_lines": [
          {
            "price": 13.5,
            "rate": 0.06,
            "title": "State tax"
          }
        ]
      }
    ],
    "transactions": [
      {
        "kind": "sale",
        "status": "success",
        "amount": 238.47
      }
    ],
    "total_tax": 13.5,
    "currency": "EUR"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459989,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:40-04:00",
    "updated_at": "2019-10-16T16:05:40-04:00",
    "number": 2,
    "note": null,
    "token": "79b48501190269e07b527a38c56f4fd7",
    "gateway": "",
    "test": false,
    "total_price": "238.47",
    "subtotal_price": "224.97",
    "total_weight": 0,
    "total_tax": "13.50",
    "taxes_included": false,
    "currency": "EUR",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "224.97",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "340.54",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:40-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "13.50",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/79b48501190269e07b527a38c56f4fd7/authenticate?key=39248e7aeafbe37e41b668ee71c76d9e",
    "presentment_currency": "EUR",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459989",
    "line_items": [
      {
        "id": 1071823197,
        "variant_id": null,
        "title": "Big Brown Bear Boots",
        "quantity": 3,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Big Brown Bear Boots",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 3,
        "grams": 1300,
        "price": "74.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823197",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "13.50",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              },
              "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create an order with tax lines split across taxable line items

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459990,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:41-04:00",
    "updated_at": "2019-10-16T16:05:41-04:00",
    "number": 2,
    "note": null,
    "token": "a04a79891455ebbd7ff38c68e1d313e8",
    "gateway": "",
    "test": false,
    "total_price": "270.37",
    "subtotal_price": "255.92",
    "total_weight": 0,
    "total_tax": "14.45",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "255.92",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "270.37",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:41-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "10.20",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "10.20",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "10.20",
            "currency_code": "USD"
          }
        }
      },
      {
        "price": "4.25",
        "rate": 0.025,
        "title": "County tax",
        "price_set": {
          "shop_money": {
            "amount": "4.25",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "4.25",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/a04a79891455ebbd7ff38c68e1d313e8/authenticate?key=c1b2fe9403c190ac3b7a2cbd6d0ec839",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "270.37",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "270.37",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "14.45",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "14.45",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459990",
    "line_items": [
      {
        "id": 1071823198,
        "variant_id": null,
        "title": "Red Leather Coat",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Red Leather Coat",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 1700,
        "price": "129.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "129.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "129.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823198",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "7.81",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "7.81",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "7.81",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "3.26",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "3.26",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.26",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 1071823199,
        "variant_id": null,
        "title": "Blue Suede Shoes",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": false,
        "gift_card": false,
        "name": "Blue Suede Shoes",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 750,
        "price": "85.95",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "85.95",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "85.95",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823199",
        "tax_lines": []
      },
      {
        "id": 1071823200,
        "variant_id": null,
        "title": "Raspberry Beret",
        "quantity": 2,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Raspberry Beret",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 2,
        "grams": 320,
        "price": "19.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "19.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "19.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823200",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "2.39",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "2.39",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "2.39",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "0.99",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "0.99",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.99",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Creating an order with tax lines both on line items and on the order fails and returns an error

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Clicky Keyboard",
        "price": 99.99,
        "grams": "600",
        "quantity": 1,
        "tax_lines": [
          {
            "price": 1.0,
            "rate": 0.01,
            "title": "Keyboard tax"
          }
        ]
      }
    ],
    "tax_lines": [
      {
        "price": 6.0,
        "rate": 0.06,
        "title": "State tax"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "order": [
      "Tax lines must be associated with either order or line item but not both"
    ]
  }
}

Create a pending order with an existing customer

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "id": 207119551
    },
    "financial_status": "pending"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459991,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:43-04:00",
    "updated_at": "2019-10-16T16:05:43-04:00",
    "number": 2,
    "note": null,
    "token": "f08815fc24c65fed5b3fbf254cb3a172",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "pending",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:43-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/f08815fc24c65fed5b3fbf254cb3a172/authenticate?key=c662919911dd8c19ddca21c9d1cccebf",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459991",
    "line_items": [
      {
        "id": 1071823201,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823201",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:05:43-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 2,
      "state": "disabled",
      "total_spent": "398.65",
      "last_order_id": 1073459991,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Create a partially paid order with a new customer and addresses

POST /admin/api/2019-07/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "first_name": "Paul",
      "last_name": "Norman",
      "email": "paul.norman@example.com"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "email": "jane@example.com",
    "transactions": [
      {
        "kind": "authorization",
        "status": "success",
        "amount": 50.0
      }
    ],
    "financial_status": "partially_paid"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459992,
    "email": "jane@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:44-04:00",
    "updated_at": "2019-10-16T16:05:44-04:00",
    "number": 2,
    "note": null,
    "token": "e925c8aed256267e9476ceb5b18477ca",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:44-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "jane@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/e925c8aed256267e9476ceb5b18477ca/authenticate?key=7e1d0cf8e8071dacaf924b3e3f6cfc5a",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459992",
    "line_items": [
      {
        "id": 1071823202,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823202",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "billing_address": {
      "first_name": "John",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "John Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "shipping_address": {
      "first_name": "Jane",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "Jane Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 1073339489,
      "email": "paul.norman@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:44-04:00",
      "updated_at": "2019-10-16T16:05:44-04:00",
      "first_name": "John",
      "last_name": "Smith",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459992,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:44-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339489",
      "default_address": {
        "id": 1053317336,
        "customer_id": 1073339489,
        "first_name": "Jane",
        "last_name": "Smith",
        "company": null,
        "address1": "123 Fake Street",
        "address2": null,
        "city": "Fakecity",
        "province": "Ontario",
        "country": "Canada",
        "zip": "K2P 1L4",
        "phone": "777-777-7777",
        "name": "Jane Smith",
        "province_code": "ON",
        "country_code": "CA",
        "country_name": "Canada",
        "default": true
      }
    }
  }
}
PUT /admin/api/2019-07/orders/#{order_id}.json
Updates an order

Add a note to order

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note": "Customer contacted us about a custom engraving on this iPod"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:45-04:00",
    "number": 1,
    "note": "Customer contacted us about a custom engraving on this iPod",
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=8155cfa3bbceabbb1d0edef7b195dd64",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add note attributes to an order

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:46-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=15010976f579ace96dd8112e57164c66",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's email address

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:47-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "a-different@email.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=7c1a0dd8ce96d5f955a323ac1373116f",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's phone number

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "phone": "+15145556677"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:48-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+15145556677",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b9aa533284a9a714082f46efa945d1aa",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change whether the buyer accepts marketing

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "buyer_accepts_marketing": true
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:49-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": true,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffda8ed25578813749d8dd508c787062",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add a metafield to an order

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:50-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0aca457a2b3b052c74d6319757af3678",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Update the shipping address of an order

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "shipping_address": {
      "address1": "123 Ship Street",
      "city": "Shipsville"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:51-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ef6881713147de7c5275468ecce51482",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "123 Ship Street",
      "phone": "555-625-1199",
      "city": "Shipsville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Remove the customer from an order

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "customer": null
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f26ab2ae733ac41257b8627419d758ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    }
  }
}

Update an order's tags

PUT /admin/api/2019-07/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "tags": "External, Inbound, Outbound"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "External, Inbound, Outbound",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=bc254a43d3744cdfa1ead8a308a26b8c",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
DELETE /admin/api/2019-07/orders/#{order_id}.json
Deletes an order. Orders that interact with an online gateway can't be deleted.

Delete an order

DELETE /admin/api/2019-07/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
}
Version 2019-10 (Latest)

An order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provide an email address or phone number, billing address and payment information.

Orders can be created through the API, but no payment information will be collected, and no transaction performed. You can mark the order with any payment status.

You can also allow merchants to create orders manually by using the DraftOrder resource.

Caution

You can't use the Order resource to create a new checkout for an individual store. To create a checkout, you need to use the Checkout API, or an SDK powered by the Storefront API, such as the JavaScript Buy SDK, iOS Buy SDK, or Android Buy SDK.

Caution

As of June 6th, 2018, only the last 60 days' worth of orders from a store will be accessible from the Order resource by default. If you want to access older orders, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders scope to your app along with read_orders or write_orders. Private apps are not affected by this change and are automatically granted the scope.

After an order is created, you can change only a few of its attributes using the API. You cannot change the items or the quantities in an order.

You can also add metafields to the Order resource.

What you can do with Order

The Shopify API lets you do the following with the Order resource. More detailed versions of these general actions may be available:

Order properties

app_id
read-only
"app_id": 1966818

The ID of the app that created the order.

billing_address
"billing_address": {
  "address1": "2259 Park Ct",
  "address2": "Apartment 5",
  "city": "Drayton Valley",
  "company": null,
  "country": "Canada",
  "first_name": "Christopher",
  "last_name": "Gorski",
  "phone": "(555)555-5555",
  "province": "Alberta",
  "zip": "T0E 0M0",
  "name": "Christopher Gorski",
  "province_code": "AB",
  "country_code": "CA",
  "latitude": "45.41634",
  "longitude": "-75.6868"
}

The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. It has the following properties:

  • address1: The street address of the billing address.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city, town, or village of the billing address.
  • company: The company of the person associated with the billing address.
  • country: The name of the country of the billing address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the billing address.
  • first_name: The first name of the person associated with the payment method.
  • last_name: The last name of the person associated with the payment method.
  • latitude: The latitude of the billing address.
  • longitude: The longitude of the billing address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the billing address.
  • province: The name of the region (province, state, prefecture, …) of the billing address.
  • province_code: The two-letter abbreviation of the region of the billing address.
  • zip: The postal code (zip, postcode, Eircode, …) of the billing address.
browser_ip
read-only
"browser_ip": "216.191.105.146"

The IP address of the browser used by the customer when they placed the order.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer consented to receive email updates from the shop.

cancel_reason
"cancel_reason": "customer"

The reason why the order was canceled. Valid values:

  • customer: The customer canceled the order.
  • fraud: The order was fraudulent.
  • inventory: Items in the order were not in inventory.
  • declined: The payment was declined.
  • other: A reason not in this list.
cancelled_at
read-only
"cancelled_at": null

The date and time ( ISO 8601 format) when the order was canceled.

cart_token
read-only
"cart_token": "68778783ad298f1c80c3bafcddeea"

The ID of the cart that's associated with the order.

client_details
read-only
"client_details": {
  "accept_language": "en-US,en;q=0.9",
  "browser_height": 1320,
  "browser_ip": "216.191.105.146",
  "browser_width": 1280,
  "session_hash": "9ad4d1f4e6a8977b9dd98eed1e477643",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36"
}

Information about the browser that the customer used when they placed their order:

  • accept_language: The languages and locales that the browser understands.
  • browser_height: The browser screen height in pixels, if available.
  • browser_ip: The browser IP address.
  • browser_width: The browser screen width in pixels, if available.
  • session_hash: A hash of the session.
  • user_agent: Details of the browsing client, including software and operating versions.
closed_at
read-only
"closed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the order was closed.

created_at
read-only
"created_at": "2008-01-10T11:00:00-05:00"

The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the shop currency.

customer
"customer": {
  "id": 207119551,
  "email": "bob.norman@hostmail.com",
  "accepts_marketing": false,
  "created_at": "2012-03-13T16:09:55-04:00",
  "updated_at": "2012-03-13T16:09:55-04:00",
  "first_name": "Bob",
  "last_name": "Norman",
  "orders_count": "1",
  "state": "disabled",
  "total_spent": "0.00",
  "last_order_id": 450789469,
  "note": null,
  "verified_email": true,
  "multipass_identifier": null,
  "tax_exempt": false,
  "tax_exemptions": {},
  "phone": "+13125551212",
  "tags": "loyal",
  "last_order_name": "#1001",
  "currency": "USD",
  "addresses": {},
  "admin_graphql_api_id": "gid://shopify/Customer/207119551",
  "default_address": {}
}

Information about the customer. The order might not have a customer and apps should not depend on the existence of a customer object. This value might be null if the order was created through Shopify POS. For more information about the customer object, see the Customer resource.

customer_locale
read-only
"customer_locale": "en-CA"

The two or three-letter language code, optionally followed by a region modifier.

discount_applications
read-only
"discount_applications": [
  {
    "type": "manual",
    "title": "custom discount",
    "description": "customer deserved it",
    "value": "2.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "line_item"
  },
  {
    "type": "script",
    "description": "my scripted discount",
    "value": "5.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "shipping_line"
  },
  {
    "type": "discount_code",
    "code": "SUMMERSALE",
    "value": "10.0",
    "value_type": "fixed_amount",
    "allocation_method": "across",
    "target_selection": "all",
    "target_type": "line_item"
  }
]

An ordered list of stacked discount applications.

The discount_applications property includes 3 types: discount_code, manual, and script. All 3 types share a common structure and have some type specific attributes.

  • allocation_method: The method by which the discount application value has been allocated to entitled lines. Valid values:
    • across: The value is spread across all entitled lines.
    • each: The value is applied onto every entitled line.
    • one: The value is applied onto a single line.
  • code: The discount code that was used to apply the discount. Available only for discount code applications.
  • description: The description of the discount application, as defined by the merchant or the Shopify Script. Available only for manual and script discount applications.
  • target_selection: The lines on the order, of the type defined by target_type, that the discount is allocated over. Valid values:
    • all: The discount is allocated onto all lines,
    • entitled: The discount is allocated only onto lines it is entitled for.
    • explicit: The discount is allocated onto explicitly selected lines.
  • target_type: The type of line on the order that the discount is applicable on. Valid values:
    • line_item: The discount applies to line items.
    • shipping_line: The discount applies to shipping lines.
  • title: The title of the discount application, as defined by the merchant. Available only for manual discount applications.
  • type: The discount application type. Valid values:
    • manual: The discount was manually applied by the merchant (for example, by using an app or creating a draft order).
    • script: The discount was applied by a Shopify Script.
    • discount_code: The discount was applied by a discount code.
  • value: The value of the discount application as a decimal. This represents the intention of the discount application. For example, if the intent was to apply a 20% discount, then the value will be 20.0. If the intent was to apply a $15 discount, then the value will be 15.0.
  • value_type: The type of the value. Valid values:
    • fixed_amount: A fixed amount discount value in the currency of the order.
    • percentage: A percentage discount value.
discount_codes
"discount_codes": [
  {
    "code": "SPRING30",
    "amount": "30.00",
    "type": "fixed_amount"
  }
]

A list of discount codes to apply to the order. Each discount code object includes the following fields:

  • amount: The value of the discount to be deducted from the order total. The type field determines how this value is calculated. After an order is created, this field returns the calculated amount.
  • code: The discount code.
  • type: The type of discount. Default value: fixed_amount. Valid values:
    • fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied.
    • percentage: Applies a discount of amount as a percentage of the order total.
    • shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30.
email
"email": "bob.norman@hostmail.com"

The customer's email address.

financial_status
"financial_status": "authorized"

The status of payments associated with the order. Can only be set when the order is created. Valid values:

  • pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully.
  • authorized: The payments have been authorized.
  • partially_paid: The order have been partially paid.
  • paid: The payments have been paid.
  • partially_refunded: The payments have been partially refunded.
  • refunded: The payments have been refunded.
  • voided: The payments have been voided.
fulfillments
"fulfillments": [
  {
    "created_at": "2012-03-13T16:09:54-04:00",
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "tracking_company": null,
    "tracking_number": "1Z2345",
    "updated_at": "2012-05-01T14:22:25-04:00"
  }
]

A list of fulfillments associated with the order. For more information, see the Fulfillment API.

fulfillment_status
"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
gateway
deprecated
"gateway": "shopify_payments"

The payment gateway used.

Use the Transaction resource instead.

id
read-only
"id": 450789469

The ID of the order, used for API purposes. This is different from the order_number property, which is the ID used by the shop owner and customer.'

landing_site
read-only
"landing_site": "http://www.example.com?source=abc"

The URL for the page where the buyer landed when they entered the shop.

line_items
required
"line_items": [
  {
    "fulfillable_quantity": 1,
    "fulfillment_service": "amazon",
    "fulfillment_status": "fulfilled",
    "grams": 500,
    "id": 669751112,
    "price": "199.99",
    "product_id": 7513594,
    "quantity": 1,
    "requires_shipping": true,
    "sku": "IPOD-342-N",
    "title": "IPod Nano",
    "variant_id": 4264112,
    "variant_title": "Pink",
    "vendor": "Apple",
    "name": "IPod Nano - Pink",
    "gift_card": false,
    "price_set": {
      "shop_money": {
        "amount": "199.99",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "173.30",
        "currency_code": "EUR"
      }
    },
    "properties": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday Mom!"
      }
    ],
    "taxable": true,
    "tax_lines": [
      {
        "title": "HST",
        "price": "25.81",
        "price_set": {
          "shop_money": {
            "amount": "25.81",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "20.15",
            "currency_code": "EUR"
          }
        },
        "rate": 0.13
      }
    ],
    "total_discount": "5.00",
    "total_discount_set": {
      "shop_money": {
        "amount": "5.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "4.30",
        "currency_code": "EUR"
      }
    },
    "discount_allocations": [
      {
        "amount": "5.00",
        "discount_application_index": 2,
        "amount_set": {
          "shop_money": {
            "amount": "5.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "3.96",
            "currency_code": "EUR"
          }
        }
      }
    ]
  }
]

A list of line item objects, each containing information about an item in the order. Each object has the following properties:

  • fulfillable_quantity: The amount available to fulfill, calculated as follows:
    quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity
  • fulfillment_service: The service provider that's fulfilling the item. Valid values: manual, or the name of the provider, such as amazon or shipwire.
  • fulfillment_status: How far along an order is in terms line items fulfilled. Valid values: null, fulfilled, partial, and not_eligible.
  • grams: The weight of the item in grams.
  • id: The ID of the line item.
  • price: The price of the item before discounts have been applied in the shop currency.
  • price_set: The price of the line item in shop and presentment currencies.
  • product_id: The ID of the product that the line item belongs to. Can be null if the original product associated with the order is deleted at a later date.
  • quantity: The number of items that were purchased.
  • requires_shipping: Whether the item requires shipping.
  • sku: The item's SKU (stock keeping unit).
  • title: The title of the product.
  • variant_id: The ID of the product variant.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.
  • name: The name of the product variant.
  • gift_card: Whether the item is a gift card. If true, then the item is not taxed or considered for shipping charges.
  • properties: An array of custom information for the item that has been added to the cart. Often used to provide product customization options. For more information, see Get customization information for products with line item properties.
  • taxable: Whether the item was taxable.
  • tax_lines: A list of tax line objects, each of which details a tax applied to the item.
    • title: The name of the tax.
    • price: The amount added to the order for this tax in the shop currency.
    • price_set: The amount added to the order for this tax in shop and presentment currencies.
    • rate: The tax rate applied to the order to calculate the tax price.
  • tip_payment_gateway: The payment gateway used to tender the tip, such as shopify_payments. Present only on tips.
  • tip_payment_method: The payment method used to tender the tip, such as Visa. Present only on tips.
  • total_discount: The total discount amount applied to this line item in the shop currency. This value is not subtracted in the line item price.
  • total_discount_set: The total discount applied to the line item in shop and presentment currencies.
  • discount_allocations: An ordered list of amounts allocated by discount applications. Each discount allocation is associated to a particular discount application.
    • amount: The discount amount allocated to the line in the shop currency.
    • discount_application_index: The index of the associated discount application in the order's discount_applications list.
    • amount_set: The discount amount allocated to the line item in shop and presentment currencies.
location_id
"location_id": 49202758

The ID of the physical location where the order was processed.

name
read-only
"name": "#1001"

The order name as represented by a number. Must start with #.

note
"note": "Customer changed their mind."

An optional note that a shop owner can attach to the order.

note_attributes
"note_attributes": [
  {
    "name": "custom name",
    "value": "custom value"
  }
]

Extra information that is added to the order. Appears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.

number
read-only
"number": 1000

For internal use only. An ID unique to the shop. Numbers are sequential and start at 1000.

order_number
read-only
"order_number": 1001

The ID of the order used by the shop owner and customer. This is different from the id property, which is the ID of the order used by the API.

payment_details
deprecated
"payment_details": {
  "avs_result_code": "Y",
  "credit_card_bin": "453600",
  "cvv_result_code": "M",
  "credit_card_number": "•••• •••• •••• 4242",
  "credit_card_company": "Visa"
}

An object containing information about the payment. It has the following properties:

  • avs_result_code: The response code from the address verification system (AVS). The code is a single letter. See this chart for the codes and their definitions.
  • credit_card_bin: The issuer identification number (IIN), formerly known as the bank identification number (BIN), of the customer's credit card. This is made up of the first few digits of the credit card number.
  • credit_card_company: The name of the company who issued the customer's credit card.
  • credit_card_number: The customer's credit card number, with most of the leading digits redacted.
  • cvv_result_code: The response code from the credit card company indicating whether the customer entered the card security code (card verification value) correctly. The code is a single letter or empty string. See this chart for the codes and their definitions.

Use the Transaction resource instead.

payment_gateway_names
read-only
"payment_gateway_names": [
  "authorize_net",
  "Cash on Delivery (COD)"
]

The list of payment gateways used for the order.

phone
"phone": "+557734881234"

The customer's phone number for receiving SMS notifications.

presentment_currency
"presentment_currency": "CAD"

The presentment currency that was used to display prices to the customer.

processed_at
"processed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created.

processing_method
read-only
"processing_method": "direct"

How the payment was processed. It has the following valid values:

referring_site
"referring_site": "http://www.anexample.com"

The website where the customer clicked a link to the shop.

refunds
read-only
"refunds": [
  {
    "id": 18423447608,
    "order_id": 394481795128,
    "created_at": "2018-03-06T09:35:37-05:00",
    "note": null,
    "user_id": null,
    "processed_at": "2018-03-06T09:35:37-05:00",
    "refund_line_items": [],
    "transactions": [],
    "order_adjustments": []
  }
]

A list of refunds applied to the order. For more information, see the Refund API.

shipping_address
"shipping_address": {
  "address1": "123 Amoebobacterieae St",
  "address2": "",
  "city": "Ottawa",
  "company": null,
  "country": "Canada",
  "first_name": "Bob",
  "last_name": "Bobsen",
  "latitude": "45.41634",
  "longitude": "-75.6868",
  "phone": "555-625-1199",
  "province": "Ontario",
  "zip": "K2P0V6",
  "name": "Bob Bobsen",
  "country_code": "CA",
  "province_code": "ON"
}

The mailing address to where the order will be shipped. This address is optional and will not be available on orders that do not require shipping. It has the following properties:

  • address1: The street address of the shipping address.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city, town, or village of the shipping address.
  • company: The company of the person associated with the shipping address.
  • country: The name of the country of the shipping address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • latitude: The latitude of the shipping address.
  • longitude: The longitude of the shipping address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the shipping address.
  • province: The name of the region (province, state, prefecture, …) of the shipping address.
  • province_code: The two-letter abbreviation of the region of the shipping address.
  • zip: The postal code (zip, postcode, Eircode, …) of the shipping address.
shipping_lines
"shipping_lines": [
  {
    "code": "INT.TP",
    "price": "4.00",
    "price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "discounted_price": "4.00",
    "discounted_price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "source": "canada_post",
    "title": "Small Packet International Air",
    "tax_lines": [],
    "carrier_identifier": "third_party_carrier_identifier",
    "requested_fulfillment_service_id": "third_party_fulfillment_service_id"
  }
]

An array of objects, each of which details a shipping method used. Each object has the following properties:

  • code: A reference to the shipping method.
  • discounted_price: The price of the shipping method after line-level discounts have been applied. Doesn't reflect cart-level or order-level discounts.
  • discounted_price_set: The price of the shipping method in both shop and presentment currencies after line-level discounts have been applied.
  • price: The price of this shipping method in the shop currency. Can't be negative.
  • price_set: The price of the shipping method in shop and presentment currencies.
  • source: The source of the shipping method.
  • title: The title of the shipping method.
  • tax_lines: A list of tax line objects, each of which details a tax applicable to this shipping line.
  • carrier_identifier: A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
  • requested_fulfillment_service_id: A reference to the fulfillment service that is being requested for the shipping method. Present if the shipping method requires processing by a third party fulfillment service; null otherwise.
source_name
"source_name": "web"

Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, shopify_draft_order, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value of your app's ID.

subtotal_price
"subtotal_price": 398.0

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

subtotal_price_set
"subtotal_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The subtotal of the order in shop and presentment currencies.

tags
"tags": "imported"

Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length.

tax_lines
"tax_lines": [
  {
    "price": 11.94,
    "rate": 0.06,
    "title": "State Tax"
  }
]

An array of tax line objects, each of which details a tax applicable to the order. Each object has the following properties:

  • price: The amount of tax to be charged in the shop currency.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.
When creating an order through the API, tax lines can be specified on the order or the line items but not both. Tax lines specified on the order are split across the taxable line items in the created order.
taxes_included
"taxes_included": false

Whether taxes are included in the order subtotal.

test
"test": true

Whether this is a test order.

token
read-only
"token": "b1946ac92492d2347c6235b4d2611184"

A unique token for the order.

total_discounts
"total_discounts": "0.00"

The total discounts applied to the price of the order in the shop currency.

total_discounts_set
"total_discounts_set": {
  "shop_money": {
    "amount": "0.00",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "0.00",
    "currency_code": "EUR"
  }
}

The total discounts applied to the price of the order in shop and presentment currencies.

total_line_items_price
"total_line_items_price": "398.00"

The sum of all line item prices in the shop currency.

total_line_items_price_set
"total_line_items_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The total of all line item prices in shop and presentment currencies.

total_price
"total_price": "409.94"

The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive.

total_price_set
"total_price_set": {
  "shop_money": {
    "amount": "164.86",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "105.31",
    "currency_code": "EUR"
  }
}

The total price of the order in shop and presentment currencies.

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the order in th shop currency. Must be positive).

total_tax_set
"total_tax_set": {
  "shop_money": {
    "amount": "18.87",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "11.82",
    "currency_code": "EUR"
  }
}

The total tax applied to the order in shop and presentment currencies.

total_tip_received
"total_tip_received": "4.87"

The sum of all the tips in the order in the shop currency.

total_weight
"total_weight": 300

The sum of all line item weights in grams.

updated_at
read-only
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format) when the order was last modified.

Filtering orders by updated_at is not an effective method for fetching orders because its value can change when no visible fields of an order have been updated. Use the Webhook and Event APIs to subscribe to order events instead.

user_id
"user_id": 31522279

The ID of the user logged into Shopify POS who processed the order, if applicable.

order_status_url
read-only
"order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35"

The URL pointing to the order status web page, if applicable.

Endpoints

GET /admin/api/2019-10/orders.json
Retrieves a list of orders. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. To learn more, see Making requests to paginated REST Admin API endpoints.
ids

Retrieve only orders specified by a comma-separated list of order IDs.

limit

The maximum number of results to show on a page.

(default: 50, maximum: 250)
since_id

Show orders after the specified ID.

created_at_min

Show orders created at or after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Show orders created at or before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Show orders last updated at or after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Show orders last updated at or before date (format: 2014-04-25T16:15:47-04:00).

processed_at_min

Show orders imported at or after date (format: 2014-04-25T16:15:47-04:00).

processed_at_max

Show orders imported at or before date (format: 2014-04-25T16:15:47-04:00).

attribution_app_id

Show orders attributed to a certain app, specified by the app ID. Set as current to show orders for the app currently consuming the API.

status

Filter orders by their status.

(default: open)
  • open: Show only open orders.
  • closed: Show only closed orders.
  • cancelled: Show only canceled orders.
  • any: Show orders of any status, including archived orders.
financial_status

Filter orders by their financial status.

(default: any)
  • authorized: Show only authorized orders
  • pending: Show only pending orders
  • paid: Show only paid orders
  • partially_paid: Show only partially paid orders
  • refunded: Show only refunded orders
  • voided: Show only voided orders
  • partially_refunded: Show only partially refunded orders
  • any: Show orders of any financial status.
  • unpaid: Show authorized and partially paid orders.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve all orders

GET /admin/api/2019-10/orders.json
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=56efacaba775fa4458ff2bba45d49740",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve specific orders

GET /admin/api/2019-10/orders.json?ids=1073459984
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 1073459984,
      "email": "",
      "closed_at": null,
      "created_at": "2019-10-16T16:05:09-04:00",
      "updated_at": "2019-10-16T16:05:09-04:00",
      "number": 2,
      "note": null,
      "token": "227df66de31d008a57f2c253a48d8876",
      "gateway": "",
      "test": false,
      "total_price": "199.00",
      "subtotal_price": "199.00",
      "total_weight": 0,
      "total_tax": "0.00",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "paid",
      "confirmed": true,
      "total_discounts": "0.00",
      "total_line_items_price": "199.00",
      "cart_token": null,
      "buyer_accepts_marketing": false,
      "name": "#1002",
      "referring_site": null,
      "landing_site": null,
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "199.00",
      "checkout_token": null,
      "reference": null,
      "user_id": null,
      "location_id": null,
      "source_identifier": null,
      "source_url": null,
      "processed_at": "2019-10-16T16:05:09-04:00",
      "device_id": null,
      "phone": null,
      "customer_locale": null,
      "app_id": 755357713,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1002,
      "discount_applications": [],
      "discount_codes": [],
      "note_attributes": [],
      "payment_gateway_names": [],
      "processing_method": "",
      "checkout_id": null,
      "source_name": "755357713",
      "fulfillment_status": null,
      "tax_lines": [],
      "tags": "",
      "contact_email": null,
      "order_status_url": "https://apple.myshopify.com/690933842/orders/227df66de31d008a57f2c253a48d8876/authenticate?key=87485ec4e50f759fe41707e4c7881cc4",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/1073459984",
      "line_items": [
        {
          "id": 1071823192,
          "variant_id": 447654529,
          "title": "IPod Touch 8GB",
          "quantity": 1,
          "sku": "IPOD2009BLACK",
          "variant_title": "Black",
          "vendor": "Apple",
          "fulfillment_service": "shipwire-app",
          "product_id": 921728736,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Touch 8GB - Black",
          "variant_inventory_management": "shipwire-app",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 567,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/1071823192",
          "tax_lines": []
        }
      ],
      "shipping_lines": [],
      "fulfillments": [],
      "refunds": []
    }
  ]
}

Retrieve orders that have authorized payments ready to be captured

GET /admin/api/2019-10/orders.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2019-10-16T16:05:11-04:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=c155ba1976e0152d665314e4f94bb18d",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve orders last updated after 2005-07-31 15:57:11 in the EDT timezone

GET /admin/api/2019-10/orders.json?updated_at_min=2005-07-31T15:57:11-04:00
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=e7c8df17f387fd029c58f7f63787e79d",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve all orders but show only certain properties

GET /admin/api/2019-10/orders.json?fields=created_at,id,name,total-price
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "created_at": "2008-01-10T11:00:00-05:00",
      "total_price": "598.94",
      "name": "#1001"
    }
  ]
}

Retrieve all orders after the specified ID

GET /admin/api/2019-10/orders.json?since_id=123
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0acf4e9d8b8329fa3d1c041f79ae13a0",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}
GET /admin/api/2019-10/orders/#{order_id}.json
Retrieves a specific order
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve a single order

GET /admin/api/2019-10/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2008-01-10T11:00:00-05:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ae8af92349ee3e1dee8b24eef131fbea",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Get only particular fields

GET /admin/api/2019-10/orders/#{order_id}.json?fields=id,line_items,name,total_price
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "total_price": "598.94",
    "name": "#1001",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ]
  }
}
GET /admin/api/2019-10/orders/count.json
Retrieves an order count
created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00).

status

Count orders of a given status.

(default: open)
  • open: Count open orders.
  • closed: Count closed orders.
  • any: Count orders of any status.
financial_status

Count orders of a given financial status.

(default: any)
  • authorized: Count authorized orders.
  • pending: Count pending orders.
  • paid: Count paid orders.
  • refunded: Count refunded orders.
  • voided: Count voided orders.
  • any: Count orders of any financial status.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.

Count all orders

GET /admin/api/2019-10/orders/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Count orders that have authorized payments ready to be captured

GET /admin/api/2019-10/orders/count.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST /admin/api/2019-10/orders/#{order_id}/close.json
Closes an order

Close an order

POST /admin/api/2019-10/orders/#{order_id}/close.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": "2019-10-16T16:05:17-04:00",
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:17-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2e921b708a09b041a65ffb02d4d1be52",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-10/orders/#{order_id}/open.json
Re-opens a closed order

Re-open a closed order

POST /admin/api/2019-10/orders/#{order_id}/open.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:19-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f370264649269e90e395c9294bd4b358",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2019-10/orders/#{order_id}/cancel.json
Cancels an order. Orders that have a fulfillment object can't be canceled.
amount

The amount to refund. If set, Shopify attempts to void or refund the payment, depending on its status.

currency

The currency of the refund that's issued when the order is canceled. Required for multi-currency orders whenever the amount property is provided.

restock
deprecated

Whether to restock refunded items back to your store's inventory.

(default: false)
reason

The reason for the order cancellation. Valid values: customer, inventory, fraud, declined, and other.)

(default: other)
email

Whether to send an email to the customer notifying them of the cancellation.

(default: false)
refund

The refund transactions to perform. Required for some more complex refund situations. For more information, see the Refund API.

Cancel an order

POST /admin/api/2019-10/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2008-01-10T11:00:00-05:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=341cf1d04694165a4cd345d0b6b81954",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Cancel and refund an order using the amount property

POST /admin/api/2019-10/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "10.00",
  "currency": "USD"
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:24-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "bogus",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=382805203a96d6c29ca7600046ba6290",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361468,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:24-04:00",
      "note": null,
      "user_id": null,
      "processed_at": "2019-10-16T16:05:24-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361468",
      "refund_line_items": [
        {
          "id": 1058498313,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498314,
          "quantity": 1,
          "line_item_id": 518995019,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 518995019,
            "variant_id": 49148385,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008RED",
            "variant_title": "red",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - red",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498315,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844705,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:24-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844704,
          "processed_at": "2019-10-16T16:05:24-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844705"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

When an order has multiple refundable transactions, refunding an amount less than its net payment without a refund property fails with an error

POST /admin/api/2019-10/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "109.00",
  "currency": "USD"
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:27-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=a64beb6670f1295ff7ff08c2f06e132b",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Refund parameter required to process refund"
}

Cancel and refund an order using the refund property

POST /admin/api/2019-10/orders/#{order_id}/cancel.json
{
  "refund": {
    "note": "Customer made a mistake",
    "shipping": {
      "full_refund": true
    },
    "refund_line_items": [
      {
        "line_item_id": 466157049,
        "quantity": 1,
        "restock_type": "cancel",
        "location_id": 48752903
      }
    ],
    "transactions": [
      {
        "parent_id": 1072844710,
        "amount": "10.00",
        "kind": "refund",
        "gateway": "bogus"
      },
      {
        "parent_id": 1072844711,
        "amount": "100.00",
        "kind": "refund",
        "gateway": "gift_card"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:32-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "gift_card",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b714067bde79ce7e56beddd5c225a955",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361469,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:32-04:00",
      "note": "Customer made a mistake",
      "user_id": null,
      "processed_at": "2019-10-16T16:05:32-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361469",
      "refund_line_items": [
        {
          "id": 1058498316,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844712,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844710,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844712"
        },
        {
          "id": 1072844713,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "gift_card",
          "status": "success",
          "message": null,
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": false,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844711,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {
            "gift_card_id": 48394658,
            "gift_card_last_characters": "0d0d"
          },
          "error_code": null,
          "source_name": "755357713",
          "amount": "100.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844713"
        }
      ],
      "order_adjustments": [
        {
          "id": 1030976845,
          "order_id": 450789469,
          "refund_id": 929361469,
          "amount": "92.98",
          "tax_amount": "0.00",
          "kind": "refund_discrepancy",
          "reason": "Refund discrepancy",
          "amount_set": {
            "shop_money": {
              "amount": "92.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "92.98",
              "currency_code": "USD"
            }
          },
          "tax_amount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Canceling an order that has fulfillments fails with an error

POST /admin/api/2019-10/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:33-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2995df0cbbf011b1b9a4be120b578ba6",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": "fulfilled",
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:05:33-04:00",
      "tracking_company": "UPS",
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Cannot cancel a paid and fulfilled order"
}
POST /admin/api/2019-10/orders.json

Creates an order. By default, product inventory is not claimed.

When you create an order, you can include the following option parameters in the body of the request:

  • inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
    • bypass: Do not claim inventory.
    • decrement_ignoring_policy: Ignore the product's inventory policy and claim inventory.
    • decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
  • send_receipt: Whether to send an order confirmation to the customer.
  • send_fulfillment_receipt: Whether to send a shipping confirmation to the customer.

Create a simple order with only a product variant ID

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459985,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:35-04:00",
    "updated_at": "2019-10-16T16:05:35-04:00",
    "number": 2,
    "note": null,
    "token": "8d9822b56c8bac57b659e0356c17130f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:35-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/8d9822b56c8bac57b659e0356c17130f/authenticate?key=78077388d47f4ce5286404667593b472",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459985",
    "line_items": [
      {
        "id": 1071823193,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823193",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create a simple order, sending an order confirmation and a shipping confirmation to the customer

POST /admin/api/2019-10/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "send_receipt": true,
    "send_fulfillment_receipt": true,
    "line_items": [
      {
        "variant_id": 457924702,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459986,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:36-04:00",
    "updated_at": "2019-10-16T16:05:36-04:00",
    "number": 2,
    "note": null,
    "token": "099ade3f1a08fd25e238d8cd0c7b21cc",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:36-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/099ade3f1a08fd25e238d8cd0c7b21cc/authenticate?key=939e30cc5de654fa267acb4f84d1ce53",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459986",
    "line_items": [
      {
        "id": 1071823194,
        "variant_id": 457924702,
        "title": "IPod Nano - 8GB",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782937,
        "order_id": 1073459986,
        "status": "success",
        "created_at": "2019-10-16T16:05:36-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:05:36-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782937",
        "line_items": [
          {
            "id": 1071823194,
            "variant_id": 457924702,
            "title": "IPod Nano - 8GB",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339486,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:36-04:00",
      "updated_at": "2019-10-16T16:05:36-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459986,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:36-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339486"
    }
  }
}

Create a simple order without sending an order receipt or a fulfillment receipt

POST /admin/api/2019-10/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459987,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:37-04:00",
    "updated_at": "2019-10-16T16:05:37-04:00",
    "number": 2,
    "note": null,
    "token": "473abaf7f739a5f62e92101d68b6ba1f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:37-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/473abaf7f739a5f62e92101d68b6ba1f/authenticate?key=aba982bdcb58f9f664a65577a33a61ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459987",
    "line_items": [
      {
        "id": 1071823195,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782938,
        "order_id": 1073459987,
        "status": "pending",
        "created_at": "2019-10-16T16:05:38-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:38-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 48752903,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782938",
        "line_items": [
          {
            "id": 1071823195,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339487,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:37-04:00",
      "updated_at": "2019-10-16T16:05:38-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459987,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:38-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339487"
    }
  }
}

Create a simple order and fulfill it

POST /admin/api/2019-10/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "fulfillments": [
      {
        "location_id": 905684977
      }
    ],
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459988,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:39-04:00",
    "updated_at": "2019-10-16T16:05:39-04:00",
    "number": 2,
    "note": null,
    "token": "596f82e63339494af345c9d2c0028d1a",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:39-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/596f82e63339494af345c9d2c0028d1a/authenticate?key=f654698e272d8a900369dbe613a14b79",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459988",
    "line_items": [
      {
        "id": 1071823196,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782939,
        "order_id": 1073459988,
        "status": "pending",
        "created_at": "2019-10-16T16:05:39-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:39-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782939",
        "line_items": [
          {
            "id": 1071823196,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339488,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:39-04:00",
      "updated_at": "2019-10-16T16:05:39-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459988,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:39-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339488"
    }
  }
}

Create a comprehensive order

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Big Brown Bear Boots",
        "price": 74.99,
        "grams": "1300",
        "quantity": 3,
        "tax_lines": [
          {
            "price": 13.5,
            "rate": 0.06,
            "title": "State tax"
          }
        ]
      }
    ],
    "transactions": [
      {
        "kind": "sale",
        "status": "success",
        "amount": 238.47
      }
    ],
    "total_tax": 13.5,
    "currency": "EUR"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459989,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:40-04:00",
    "updated_at": "2019-10-16T16:05:40-04:00",
    "number": 2,
    "note": null,
    "token": "79b48501190269e07b527a38c56f4fd7",
    "gateway": "",
    "test": false,
    "total_price": "238.47",
    "subtotal_price": "224.97",
    "total_weight": 0,
    "total_tax": "13.50",
    "taxes_included": false,
    "currency": "EUR",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "224.97",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "340.54",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:40-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "13.50",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/79b48501190269e07b527a38c56f4fd7/authenticate?key=39248e7aeafbe37e41b668ee71c76d9e",
    "presentment_currency": "EUR",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459989",
    "line_items": [
      {
        "id": 1071823197,
        "variant_id": null,
        "title": "Big Brown Bear Boots",
        "quantity": 3,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Big Brown Bear Boots",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 3,
        "grams": 1300,
        "price": "74.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823197",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "13.50",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              },
              "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create an order with tax lines split across taxable line items

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459990,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:41-04:00",
    "updated_at": "2019-10-16T16:05:41-04:00",
    "number": 2,
    "note": null,
    "token": "a04a79891455ebbd7ff38c68e1d313e8",
    "gateway": "",
    "test": false,
    "total_price": "270.37",
    "subtotal_price": "255.92",
    "total_weight": 0,
    "total_tax": "14.45",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "255.92",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "270.37",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:41-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "10.20",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "10.20",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "10.20",
            "currency_code": "USD"
          }
        }
      },
      {
        "price": "4.25",
        "rate": 0.025,
        "title": "County tax",
        "price_set": {
          "shop_money": {
            "amount": "4.25",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "4.25",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/a04a79891455ebbd7ff38c68e1d313e8/authenticate?key=c1b2fe9403c190ac3b7a2cbd6d0ec839",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "270.37",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "270.37",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "14.45",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "14.45",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459990",
    "line_items": [
      {
        "id": 1071823198,
        "variant_id": null,
        "title": "Red Leather Coat",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Red Leather Coat",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 1700,
        "price": "129.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "129.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "129.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823198",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "7.81",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "7.81",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "7.81",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "3.26",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "3.26",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.26",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 1071823199,
        "variant_id": null,
        "title": "Blue Suede Shoes",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": false,
        "gift_card": false,
        "name": "Blue Suede Shoes",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 750,
        "price": "85.95",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "85.95",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "85.95",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823199",
        "tax_lines": []
      },
      {
        "id": 1071823200,
        "variant_id": null,
        "title": "Raspberry Beret",
        "quantity": 2,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Raspberry Beret",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 2,
        "grams": 320,
        "price": "19.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "19.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "19.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823200",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "2.39",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "2.39",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "2.39",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "0.99",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "0.99",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.99",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Creating an order with tax lines both on line items and on the order fails and returns an error

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Clicky Keyboard",
        "price": 99.99,
        "grams": "600",
        "quantity": 1,
        "tax_lines": [
          {
            "price": 1.0,
            "rate": 0.01,
            "title": "Keyboard tax"
          }
        ]
      }
    ],
    "tax_lines": [
      {
        "price": 6.0,
        "rate": 0.06,
        "title": "State tax"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "order": [
      "Tax lines must be associated with either order or line item but not both"
    ]
  }
}

Create a pending order with an existing customer

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "id": 207119551
    },
    "financial_status": "pending"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459991,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:43-04:00",
    "updated_at": "2019-10-16T16:05:43-04:00",
    "number": 2,
    "note": null,
    "token": "f08815fc24c65fed5b3fbf254cb3a172",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "pending",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:43-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/f08815fc24c65fed5b3fbf254cb3a172/authenticate?key=c662919911dd8c19ddca21c9d1cccebf",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459991",
    "line_items": [
      {
        "id": 1071823201,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823201",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:05:43-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 2,
      "state": "disabled",
      "total_spent": "398.65",
      "last_order_id": 1073459991,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Create a partially paid order with a new customer and addresses

POST /admin/api/2019-10/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "first_name": "Paul",
      "last_name": "Norman",
      "email": "paul.norman@example.com"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "email": "jane@example.com",
    "transactions": [
      {
        "kind": "authorization",
        "status": "success",
        "amount": 50.0
      }
    ],
    "financial_status": "partially_paid"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459992,
    "email": "jane@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:44-04:00",
    "updated_at": "2019-10-16T16:05:44-04:00",
    "number": 2,
    "note": null,
    "token": "e925c8aed256267e9476ceb5b18477ca",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:44-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "jane@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/e925c8aed256267e9476ceb5b18477ca/authenticate?key=7e1d0cf8e8071dacaf924b3e3f6cfc5a",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459992",
    "line_items": [
      {
        "id": 1071823202,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823202",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "billing_address": {
      "first_name": "John",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "John Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "shipping_address": {
      "first_name": "Jane",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "Jane Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 1073339489,
      "email": "paul.norman@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:44-04:00",
      "updated_at": "2019-10-16T16:05:44-04:00",
      "first_name": "John",
      "last_name": "Smith",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459992,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:44-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339489",
      "default_address": {
        "id": 1053317336,
        "customer_id": 1073339489,
        "first_name": "Jane",
        "last_name": "Smith",
        "company": null,
        "address1": "123 Fake Street",
        "address2": null,
        "city": "Fakecity",
        "province": "Ontario",
        "country": "Canada",
        "zip": "K2P 1L4",
        "phone": "777-777-7777",
        "name": "Jane Smith",
        "province_code": "ON",
        "country_code": "CA",
        "country_name": "Canada",
        "default": true
      }
    }
  }
}
PUT /admin/api/2019-10/orders/#{order_id}.json
Updates an order

Add a note to order

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note": "Customer contacted us about a custom engraving on this iPod"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:45-04:00",
    "number": 1,
    "note": "Customer contacted us about a custom engraving on this iPod",
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=8155cfa3bbceabbb1d0edef7b195dd64",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add note attributes to an order

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:46-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=15010976f579ace96dd8112e57164c66",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's email address

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:47-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "a-different@email.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=7c1a0dd8ce96d5f955a323ac1373116f",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's phone number

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "phone": "+15145556677"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:48-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+15145556677",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b9aa533284a9a714082f46efa945d1aa",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change whether the buyer accepts marketing

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "buyer_accepts_marketing": true
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:49-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": true,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffda8ed25578813749d8dd508c787062",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add a metafield to an order

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:50-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0aca457a2b3b052c74d6319757af3678",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Update the shipping address of an order

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "shipping_address": {
      "address1": "123 Ship Street",
      "city": "Shipsville"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:51-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ef6881713147de7c5275468ecce51482",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "123 Ship Street",
      "phone": "555-625-1199",
      "city": "Shipsville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Remove the customer from an order

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "customer": null
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f26ab2ae733ac41257b8627419d758ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    }
  }
}

Update an order's tags

PUT /admin/api/2019-10/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "tags": "External, Inbound, Outbound"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "External, Inbound, Outbound",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=bc254a43d3744cdfa1ead8a308a26b8c",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
DELETE /admin/api/2019-10/orders/#{order_id}.json
Deletes an order. Orders that interact with an online gateway can't be deleted.

Delete an order

DELETE /admin/api/2019-10/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
}
Version 2020-01 (Release candidate)

An order is a customer's completed request to purchase one or more products from a shop. An order is created when a customer completes the checkout process, during which time they provide an email address or phone number, billing address and payment information.

Orders can be created through the API, but no payment information will be collected, and no transaction performed. You can mark the order with any payment status.

You can also allow merchants to create orders manually by using the DraftOrder resource.

Caution

You can't use the Order resource to create a new checkout for an individual store. To create a checkout, you need to use the Checkout API, or an SDK powered by the Storefront API, such as the JavaScript Buy SDK, iOS Buy SDK, or Android Buy SDK.

Caution

As of June 6th, 2018, only the last 60 days' worth of orders from a store will be accessible from the Order resource by default. If you want to access older orders, then you need to request access to all orders. If your app is granted access, then you can add the read_all_orders scope to your app along with read_orders or write_orders. Private apps are not affected by this change and are automatically granted the scope.

After an order is created, you can change only a few of its attributes using the API. You cannot change the items or the quantities in an order.

You can also add metafields to the Order resource.

What you can do with Order

The Shopify API lets you do the following with the Order resource. More detailed versions of these general actions may be available:

Order properties

app_id
read-only
"app_id": 1966818

The ID of the app that created the order.

billing_address
"billing_address": {
  "address1": "2259 Park Ct",
  "address2": "Apartment 5",
  "city": "Drayton Valley",
  "company": null,
  "country": "Canada",
  "first_name": "Christopher",
  "last_name": "Gorski",
  "phone": "(555)555-5555",
  "province": "Alberta",
  "zip": "T0E 0M0",
  "name": "Christopher Gorski",
  "province_code": "AB",
  "country_code": "CA",
  "latitude": "45.41634",
  "longitude": "-75.6868"
}

The mailing address associated with the payment method. This address is an optional field that won't be available on orders that do not require a payment method. It has the following properties:

  • address1: The street address of the billing address.
  • address2: An optional additional field for the street address of the billing address.
  • city: The city, town, or village of the billing address.
  • company: The company of the person associated with the billing address.
  • country: The name of the country of the billing address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the billing address.
  • first_name: The first name of the person associated with the payment method.
  • last_name: The last name of the person associated with the payment method.
  • latitude: The latitude of the billing address.
  • longitude: The longitude of the billing address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the billing address.
  • province: The name of the region (province, state, prefecture, …) of the billing address.
  • province_code: The two-letter abbreviation of the region of the billing address.
  • zip: The postal code (zip, postcode, Eircode, …) of the billing address.
browser_ip
read-only
"browser_ip": "216.191.105.146"

The IP address of the browser used by the customer when they placed the order.

buyer_accepts_marketing
"buyer_accepts_marketing": false

Whether the customer consented to receive email updates from the shop.

cancel_reason
"cancel_reason": "customer"

The reason why the order was canceled. Valid values:

  • customer: The customer canceled the order.
  • fraud: The order was fraudulent.
  • inventory: Items in the order were not in inventory.
  • declined: The payment was declined.
  • other: A reason not in this list.
cancelled_at
read-only
"cancelled_at": null

The date and time ( ISO 8601 format) when the order was canceled.

cart_token
read-only
"cart_token": "68778783ad298f1c80c3bafcddeea"

The ID of the cart that's associated with the order.

client_details
read-only
"client_details": {
  "accept_language": "en-US,en;q=0.9",
  "browser_height": 1320,
  "browser_ip": "216.191.105.146",
  "browser_width": 1280,
  "session_hash": "9ad4d1f4e6a8977b9dd98eed1e477643",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.94 Safari/537.36"
}

Information about the browser that the customer used when they placed their order:

  • accept_language: The languages and locales that the browser understands.
  • browser_height: The browser screen height in pixels, if available.
  • browser_ip: The browser IP address.
  • browser_width: The browser screen width in pixels, if available.
  • session_hash: A hash of the session.
  • user_agent: Details of the browsing client, including software and operating versions.
closed_at
read-only
"closed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when the order was closed.

created_at
read-only
"created_at": "2008-01-10T11:00:00-05:00"

The autogenerated date and time (ISO 8601 format) when the order was created in Shopify. The value for this property cannot be changed.

currency
"currency": "USD"

The three-letter code (ISO 4217 format) for the shop currency.

customer
"customer": {
  "id": 207119551,
  "email": "bob.norman@hostmail.com",
  "accepts_marketing": false,
  "created_at": "2012-03-13T16:09:55-04:00",
  "updated_at": "2012-03-13T16:09:55-04:00",
  "first_name": "Bob",
  "last_name": "Norman",
  "orders_count": "1",
  "state": "disabled",
  "total_spent": "0.00",
  "last_order_id": 450789469,
  "note": null,
  "verified_email": true,
  "multipass_identifier": null,
  "tax_exempt": false,
  "tax_exemptions": {},
  "phone": "+13125551212",
  "tags": "loyal",
  "last_order_name": "#1001",
  "currency": "USD",
  "addresses": {},
  "admin_graphql_api_id": "gid://shopify/Customer/207119551",
  "default_address": {}
}

Information about the customer. The order might not have a customer and apps should not depend on the existence of a customer object. This value might be null if the order was created through Shopify POS. For more information about the customer object, see the Customer resource.

customer_locale
read-only
"customer_locale": "en-CA"

The two or three-letter language code, optionally followed by a region modifier.

discount_applications
read-only
"discount_applications": [
  {
    "type": "manual",
    "title": "custom discount",
    "description": "customer deserved it",
    "value": "2.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "line_item"
  },
  {
    "type": "script",
    "description": "my scripted discount",
    "value": "5.0",
    "value_type": "fixed_amount",
    "allocation_method": "one",
    "target_selection": "explicit",
    "target_type": "shipping_line"
  },
  {
    "type": "discount_code",
    "code": "SUMMERSALE",
    "value": "10.0",
    "value_type": "fixed_amount",
    "allocation_method": "across",
    "target_selection": "all",
    "target_type": "line_item"
  }
]

An ordered list of stacked discount applications.

The discount_applications property includes 3 types: discount_code, manual, and script. All 3 types share a common structure and have some type specific attributes.

  • allocation_method: The method by which the discount application value has been allocated to entitled lines. Valid values:
    • across: The value is spread across all entitled lines.
    • each: The value is applied onto every entitled line.
    • one: The value is applied onto a single line.
  • code: The discount code that was used to apply the discount. Available only for discount code applications.
  • description: The description of the discount application, as defined by the merchant or the Shopify Script. Available only for manual and script discount applications.
  • target_selection: The lines on the order, of the type defined by target_type, that the discount is allocated over. Valid values:
    • all: The discount is allocated onto all lines,
    • entitled: The discount is allocated only onto lines it is entitled for.
    • explicit: The discount is allocated onto explicitly selected lines.
  • target_type: The type of line on the order that the discount is applicable on. Valid values:
    • line_item: The discount applies to line items.
    • shipping_line: The discount applies to shipping lines.
  • title: The title of the discount application, as defined by the merchant. Available only for manual discount applications.
  • type: The discount application type. Valid values:
    • manual: The discount was manually applied by the merchant (for example, by using an app or creating a draft order).
    • script: The discount was applied by a Shopify Script.
    • discount_code: The discount was applied by a discount code.
  • value: The value of the discount application as a decimal. This represents the intention of the discount application. For example, if the intent was to apply a 20% discount, then the value will be 20.0. If the intent was to apply a $15 discount, then the value will be 15.0.
  • value_type: The type of the value. Valid values:
    • fixed_amount: A fixed amount discount value in the currency of the order.
    • percentage: A percentage discount value.
discount_codes
"discount_codes": [
  {
    "code": "SPRING30",
    "amount": "30.00",
    "type": "fixed_amount"
  }
]

A list of discount codes to apply to the order. Each discount code object includes the following fields:

  • amount: The value of the discount to be deducted from the order total. The type field determines how this value is calculated. After an order is created, this field returns the calculated amount.
  • code: The discount code.
  • type: The type of discount. Default value: fixed_amount. Valid values:
    • fixed_amount: Applies amount as a unit of the store's currency. For example, if amount is 30 and the store's currency is USD, then 30 USD is deducted from the order total when the discount is applied.
    • percentage: Applies a discount of amount as a percentage of the order total.
    • shipping: Applies a free shipping discount on orders that have a shipping rate less than or equal to amount. For example, if amount is 30, then the discount will give the customer free shipping for any shipping rate that is less than or equal to $30.
email
"email": "bob.norman@hostmail.com"

The customer's email address.

financial_status
"financial_status": "authorized"

The status of payments associated with the order. Can only be set when the order is created. Valid values:

  • pending: The payments are pending. Payment might fail in this state. Check again to confirm whether the payments have been paid successfully.
  • authorized: The payments have been authorized.
  • partially_paid: The order have been partially paid.
  • paid: The payments have been paid.
  • partially_refunded: The payments have been partially refunded.
  • refunded: The payments have been refunded.
  • voided: The payments have been voided.
fulfillments
"fulfillments": [
  {
    "created_at": "2012-03-13T16:09:54-04:00",
    "id": 255858046,
    "order_id": 450789469,
    "status": "failure",
    "tracking_company": null,
    "tracking_number": "1Z2345",
    "updated_at": "2012-05-01T14:22:25-04:00"
  }
]

A list of fulfillments associated with the order. For more information, see the Fulfillment API.

fulfillment_status
"fulfillment_status": "partial"

The order's status in terms of fulfilled line items. Valid values:

  • fulfilled: Every line item in the order has been fulfilled.
  • null: None of the line items in the order have been fulfilled.
  • partial: At least one line item in the order has been fulfilled.
  • restocked: Every line item in the order has been restocked and the order canceled.
gateway
deprecated
"gateway": "shopify_payments"

The payment gateway used.

Use the Transaction resource instead.

id
read-only
"id": 450789469

The ID of the order, used for API purposes. This is different from the order_number property, which is the ID used by the shop owner and customer.'

landing_site
read-only
"landing_site": "http://www.example.com?source=abc"

The URL for the page where the buyer landed when they entered the shop.

line_items
required
"line_items": [
  {
    "fulfillable_quantity": 1,
    "fulfillment_service": "amazon",
    "fulfillment_status": "fulfilled",
    "grams": 500,
    "id": 669751112,
    "price": "199.99",
    "product_id": 7513594,
    "quantity": 1,
    "requires_shipping": true,
    "sku": "IPOD-342-N",
    "title": "IPod Nano",
    "variant_id": 4264112,
    "variant_title": "Pink",
    "vendor": "Apple",
    "name": "IPod Nano - Pink",
    "gift_card": false,
    "price_set": {
      "shop_money": {
        "amount": "199.99",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "173.30",
        "currency_code": "EUR"
      }
    },
    "properties": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday Mom!"
      }
    ],
    "taxable": true,
    "tax_lines": [
      {
        "title": "HST",
        "price": "25.81",
        "price_set": {
          "shop_money": {
            "amount": "25.81",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "20.15",
            "currency_code": "EUR"
          }
        },
        "rate": 0.13
      }
    ],
    "total_discount": "5.00",
    "total_discount_set": {
      "shop_money": {
        "amount": "5.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "4.30",
        "currency_code": "EUR"
      }
    },
    "discount_allocations": [
      {
        "amount": "5.00",
        "discount_application_index": 2,
        "amount_set": {
          "shop_money": {
            "amount": "5.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "3.96",
            "currency_code": "EUR"
          }
        }
      }
    ]
  }
]

A list of line item objects, each containing information about an item in the order. Each object has the following properties:

  • fulfillable_quantity: The amount available to fulfill, calculated as follows:
    quantity - max(refunded_quantity, fulfilled_quantity) - pending_fulfilled_quantity - open_fulfilled_quantity
  • fulfillment_service: The service provider that's fulfilling the item. Valid values: manual, or the name of the provider, such as amazon or shipwire.
  • fulfillment_status: How far along an order is in terms line items fulfilled. Valid values: null, fulfilled, partial, and not_eligible.
  • grams: The weight of the item in grams.
  • id: The ID of the line item.
  • price: The price of the item before discounts have been applied in the shop currency.
  • price_set: The price of the line item in shop and presentment currencies.
  • product_id: The ID of the product that the line item belongs to. Can be null if the original product associated with the order is deleted at a later date.
  • quantity: The number of items that were purchased.
  • requires_shipping: Whether the item requires shipping.
  • sku: The item's SKU (stock keeping unit).
  • title: The title of the product.
  • variant_id: The ID of the product variant.
  • variant_title: The title of the product variant.
  • vendor: The name of the item's supplier.
  • name: The name of the product variant.
  • gift_card: Whether the item is a gift card. If true, then the item is not taxed or considered for shipping charges.
  • properties: An array of custom information for the item that has been added to the cart. Often used to provide product customization options. For more information, see Get customization information for products with line item properties.
  • taxable: Whether the item was taxable.
  • tax_lines: A list of tax line objects, each of which details a tax applied to the item.
    • title: The name of the tax.
    • price: The amount added to the order for this tax in the shop currency.
    • price_set: The amount added to the order for this tax in shop and presentment currencies.
    • rate: The tax rate applied to the order to calculate the tax price.
  • tip_payment_gateway: The payment gateway used to tender the tip, such as shopify_payments. Present only on tips.
  • tip_payment_method: The payment method used to tender the tip, such as Visa. Present only on tips.
  • total_discount: The total discount amount applied to this line item in the shop currency. This value is not subtracted in the line item price.
  • total_discount_set: The total discount applied to the line item in shop and presentment currencies.
  • discount_allocations: An ordered list of amounts allocated by discount applications. Each discount allocation is associated to a particular discount application.
    • amount: The discount amount allocated to the line in the shop currency.
    • discount_application_index: The index of the associated discount application in the order's discount_applications list.
    • amount_set: The discount amount allocated to the line item in shop and presentment currencies.
location_id
"location_id": 49202758

The ID of the physical location where the order was processed.

name
read-only
"name": "#1001"

The order name as represented by a number. Must start with #.

note
"note": "Customer changed their mind."

An optional note that a shop owner can attach to the order.

note_attributes
"note_attributes": [
  {
    "name": "custom name",
    "value": "custom value"
  }
]

Extra information that is added to the order. Appears in the Additional details section of an order details page. Each array entry must contain a hash with name and value keys.

number
read-only
"number": 1000

For internal use only. An ID unique to the shop. Numbers are sequential and start at 1000.

order_number
read-only
"order_number": 1001

The ID of the order used by the shop owner and customer. This is different from the id property, which is the ID of the order used by the API.

payment_details
deprecated
"payment_details": {
  "avs_result_code": "Y",
  "credit_card_bin": "453600",
  "cvv_result_code": "M",
  "credit_card_number": "•••• •••• •••• 4242",
  "credit_card_company": "Visa"
}

An object containing information about the payment. It has the following properties:

  • avs_result_code: The response code from the address verification system (AVS). The code is a single letter. See this chart for the codes and their definitions.
  • credit_card_bin: The issuer identification number (IIN), formerly known as the bank identification number (BIN), of the customer's credit card. This is made up of the first few digits of the credit card number.
  • credit_card_company: The name of the company who issued the customer's credit card.
  • credit_card_number: The customer's credit card number, with most of the leading digits redacted.
  • cvv_result_code: The response code from the credit card company indicating whether the customer entered the card security code (card verification value) correctly. The code is a single letter or empty string. See this chart for the codes and their definitions.

Use the Transaction resource instead.

payment_gateway_names
read-only
"payment_gateway_names": [
  "authorize_net",
  "Cash on Delivery (COD)"
]

The list of payment gateways used for the order.

phone
"phone": "+557734881234"

The customer's phone number for receiving SMS notifications.

presentment_currency
"presentment_currency": "CAD"

The presentment currency that was used to display prices to the customer.

processed_at
"processed_at": "2008-01-10T11:00:00-05:00"

The date and time (ISO 8601 format) when an order was processed. This value is the date that appears on your orders and that's used in the analytic reports. By default, it matches the created_at value. If you're importing orders from an app or another platform, then you can set processed_at to a date and time in the past to match when the original order was created.

processing_method
read-only
"processing_method": "direct"

How the payment was processed. It has the following valid values:

referring_site
"referring_site": "http://www.anexample.com"

The website where the customer clicked a link to the shop.

refunds
read-only
"refunds": [
  {
    "id": 18423447608,
    "order_id": 394481795128,
    "created_at": "2018-03-06T09:35:37-05:00",
    "note": null,
    "user_id": null,
    "processed_at": "2018-03-06T09:35:37-05:00",
    "refund_line_items": [],
    "transactions": [],
    "order_adjustments": []
  }
]

A list of refunds applied to the order. For more information, see the Refund API.

shipping_address
"shipping_address": {
  "address1": "123 Amoebobacterieae St",
  "address2": "",
  "city": "Ottawa",
  "company": null,
  "country": "Canada",
  "first_name": "Bob",
  "last_name": "Bobsen",
  "latitude": "45.41634",
  "longitude": "-75.6868",
  "phone": "555-625-1199",
  "province": "Ontario",
  "zip": "K2P0V6",
  "name": "Bob Bobsen",
  "country_code": "CA",
  "province_code": "ON"
}

The mailing address to where the order will be shipped. This address is optional and will not be available on orders that do not require shipping. It has the following properties:

  • address1: The street address of the shipping address.
  • address2: An optional additional field for the street address of the shipping address.
  • city: The city, town, or village of the shipping address.
  • company: The company of the person associated with the shipping address.
  • country: The name of the country of the shipping address.
  • country_code: The two-letter code (ISO 3166-1 format) for the country of the shipping address.
  • first_name: The first name of the person associated with the shipping address.
  • last_name: The last name of the person associated with the shipping address.
  • latitude: The latitude of the shipping address.
  • longitude: The longitude of the shipping address.
  • name: The full name of the person associated with the payment method.
  • phone: The phone number at the shipping address.
  • province: The name of the region (province, state, prefecture, …) of the shipping address.
  • province_code: The two-letter abbreviation of the region of the shipping address.
  • zip: The postal code (zip, postcode, Eircode, …) of the shipping address.
shipping_lines
"shipping_lines": [
  {
    "code": "INT.TP",
    "price": "4.00",
    "price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "discounted_price": "4.00",
    "discounted_price_set": {
      "shop_money": {
        "amount": "4.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "3.17",
        "currency_code": "EUR"
      }
    },
    "source": "canada_post",
    "title": "Small Packet International Air",
    "tax_lines": [],
    "carrier_identifier": "third_party_carrier_identifier",
    "requested_fulfillment_service_id": "third_party_fulfillment_service_id"
  }
]

An array of objects, each of which details a shipping method used. Each object has the following properties:

  • code: A reference to the shipping method.
  • discounted_price: The price of the shipping method after line-level discounts have been applied. Doesn't reflect cart-level or order-level discounts.
  • discounted_price_set: The price of the shipping method in both shop and presentment currencies after line-level discounts have been applied.
  • price: The price of this shipping method in the shop currency. Can't be negative.
  • price_set: The price of the shipping method in shop and presentment currencies.
  • source: The source of the shipping method.
  • title: The title of the shipping method.
  • tax_lines: A list of tax line objects, each of which details a tax applicable to this shipping line.
  • carrier_identifier: A reference to the carrier service that provided the rate. Present when the rate was computed by a third-party carrier service.
  • requested_fulfillment_service_id: A reference to the fulfillment service that is being requested for the shipping method. Present if the shipping method requires processing by a third party fulfillment service; null otherwise.
source_name
"source_name": "web"

Where the order originated. Can be set only during order creation, and is not writeable afterwards. Values for Shopify channels are protected and cannot be assigned by other API clients: web, pos, shopify_draft_order, iphone, and android. Orders created via the API can be assigned any other string of your choice. If unspecified, then new orders are assigned the value of your app's ID.

subtotal_price
"subtotal_price": 398.0

The price of the order in the shop currency after discounts but before shipping, taxes, and tips.

subtotal_price_set
"subtotal_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The subtotal of the order in shop and presentment currencies.

tags
"tags": "imported"

Tags attached to the order, formatted as a string of comma-separated values. Tags are additional short descriptors, commonly used for filtering and searching. Each individual tag is limited to 40 characters in length.

tax_lines
"tax_lines": [
  {
    "price": 11.94,
    "rate": 0.06,
    "title": "State Tax"
  }
]

An array of tax line objects, each of which details a tax applicable to the order. Each object has the following properties:

  • price: The amount of tax to be charged in the shop currency.
  • rate: The rate of tax to be applied.
  • title: The name of the tax.
When creating an order through the API, tax lines can be specified on the order or the line items but not both. Tax lines specified on the order are split across the taxable line items in the created order.
taxes_included
"taxes_included": false

Whether taxes are included in the order subtotal.

test
"test": true

Whether this is a test order.

token
read-only
"token": "b1946ac92492d2347c6235b4d2611184"

A unique token for the order.

total_discounts
"total_discounts": "0.00"

The total discounts applied to the price of the order in the shop currency.

total_discounts_set
"total_discounts_set": {
  "shop_money": {
    "amount": "0.00",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "0.00",
    "currency_code": "EUR"
  }
}

The total discounts applied to the price of the order in shop and presentment currencies.

total_line_items_price
"total_line_items_price": "398.00"

The sum of all line item prices in the shop currency.

total_line_items_price_set
"total_line_items_price_set": {
  "shop_money": {
    "amount": "141.99",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "90.95",
    "currency_code": "EUR"
  }
}

The total of all line item prices in shop and presentment currencies.

total_price
"total_price": "409.94"

The sum of all line item prices, discounts, shipping, taxes, and tips in the shop currency. Must be positive.

total_price_set
"total_price_set": {
  "shop_money": {
    "amount": "164.86",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "105.31",
    "currency_code": "EUR"
  }
}

The total price of the order in shop and presentment currencies.

total_tax
"total_tax": "11.94"

The sum of all the taxes applied to the order in th shop currency. Must be positive).

total_tax_set
"total_tax_set": {
  "shop_money": {
    "amount": "18.87",
    "currency_code": "CAD"
  },
  "presentment_money": {
    "amount": "11.82",
    "currency_code": "EUR"
  }
}

The total tax applied to the order in shop and presentment currencies.

total_tip_received
"total_tip_received": "4.87"

The sum of all the tips in the order in the shop currency.

total_weight
"total_weight": 300

The sum of all line item weights in grams.

updated_at
read-only
"updated_at": "2012-08-24T14:02:15-04:00"

The date and time (ISO 8601 format) when the order was last modified.

Filtering orders by updated_at is not an effective method for fetching orders because its value can change when no visible fields of an order have been updated. Use the Webhook and Event APIs to subscribe to order events instead.

user_id
"user_id": 31522279

The ID of the user logged into Shopify POS who processed the order, if applicable.

order_status_url
read-only
"order_status_url": "https://checkout.shopify.com/112233/checkouts/4207896aad57dfb159/thank_you_token?key=753621327b9e8a64789651bf221dfe35"

The URL pointing to the order status web page, if applicable.

Endpoints

GET /admin/api/2020-01/orders.json
Retrieves a list of orders. Note: As of version 2019-10, this endpoint implements pagination by using links that are provided in the response header. To learn more, see Making requests to paginated REST Admin API endpoints.
ids

Retrieve only orders specified by a comma-separated list of order IDs.

limit

The maximum number of results to show on a page.

(default: 50, maximum: 250)
since_id

Show orders after the specified ID.

created_at_min

Show orders created at or after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Show orders created at or before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Show orders last updated at or after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Show orders last updated at or before date (format: 2014-04-25T16:15:47-04:00).

processed_at_min

Show orders imported at or after date (format: 2014-04-25T16:15:47-04:00).

processed_at_max

Show orders imported at or before date (format: 2014-04-25T16:15:47-04:00).

attribution_app_id

Show orders attributed to a certain app, specified by the app ID. Set as current to show orders for the app currently consuming the API.

status

Filter orders by their status.

(default: open)
  • open: Show only open orders.
  • closed: Show only closed orders.
  • cancelled: Show only canceled orders.
  • any: Show orders of any status, including archived orders.
financial_status

Filter orders by their financial status.

(default: any)
  • authorized: Show only authorized orders
  • pending: Show only pending orders
  • paid: Show only paid orders
  • partially_paid: Show only partially paid orders
  • refunded: Show only refunded orders
  • voided: Show only voided orders
  • partially_refunded: Show only partially refunded orders
  • any: Show orders of any financial status.
  • unpaid: Show authorized and partially paid orders.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve all orders

GET /admin/api/2020-01/orders.json
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=56efacaba775fa4458ff2bba45d49740",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve specific orders

GET /admin/api/2020-01/orders.json?ids=1073459984
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 1073459984,
      "email": "",
      "closed_at": null,
      "created_at": "2019-10-16T16:05:09-04:00",
      "updated_at": "2019-10-16T16:05:09-04:00",
      "number": 2,
      "note": null,
      "token": "227df66de31d008a57f2c253a48d8876",
      "gateway": "",
      "test": false,
      "total_price": "199.00",
      "subtotal_price": "199.00",
      "total_weight": 0,
      "total_tax": "0.00",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "paid",
      "confirmed": true,
      "total_discounts": "0.00",
      "total_line_items_price": "199.00",
      "cart_token": null,
      "buyer_accepts_marketing": false,
      "name": "#1002",
      "referring_site": null,
      "landing_site": null,
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "199.00",
      "checkout_token": null,
      "reference": null,
      "user_id": null,
      "location_id": null,
      "source_identifier": null,
      "source_url": null,
      "processed_at": "2019-10-16T16:05:09-04:00",
      "device_id": null,
      "phone": null,
      "customer_locale": null,
      "app_id": 755357713,
      "browser_ip": null,
      "landing_site_ref": null,
      "order_number": 1002,
      "discount_applications": [],
      "discount_codes": [],
      "note_attributes": [],
      "payment_gateway_names": [],
      "processing_method": "",
      "checkout_id": null,
      "source_name": "755357713",
      "fulfillment_status": null,
      "tax_lines": [],
      "tags": "",
      "contact_email": null,
      "order_status_url": "https://apple.myshopify.com/690933842/orders/227df66de31d008a57f2c253a48d8876/authenticate?key=87485ec4e50f759fe41707e4c7881cc4",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/1073459984",
      "line_items": [
        {
          "id": 1071823192,
          "variant_id": 447654529,
          "title": "IPod Touch 8GB",
          "quantity": 1,
          "sku": "IPOD2009BLACK",
          "variant_title": "Black",
          "vendor": "Apple",
          "fulfillment_service": "shipwire-app",
          "product_id": 921728736,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Touch 8GB - Black",
          "variant_inventory_management": "shipwire-app",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 567,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/1071823192",
          "tax_lines": []
        }
      ],
      "shipping_lines": [],
      "fulfillments": [],
      "refunds": []
    }
  ]
}

Retrieve orders that have authorized payments ready to be captured

GET /admin/api/2020-01/orders.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2019-10-16T16:05:11-04:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "authorized",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=c155ba1976e0152d665314e4f94bb18d",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve orders last updated after 2005-07-31 15:57:11 in the EDT timezone

GET /admin/api/2020-01/orders.json?updated_at_min=2005-07-31T15:57:11-04:00
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=e7c8df17f387fd029c58f7f63787e79d",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}

Retrieve all orders but show only certain properties

GET /admin/api/2020-01/orders.json?fields=created_at,id,name,total-price
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "created_at": "2008-01-10T11:00:00-05:00",
      "total_price": "598.94",
      "name": "#1001"
    }
  ]
}

Retrieve all orders after the specified ID

GET /admin/api/2020-01/orders.json?since_id=123
View Response
HTTP/1.1 200 OK
{
  "orders": [
    {
      "id": 450789469,
      "email": "bob.norman@hostmail.com",
      "closed_at": null,
      "created_at": "2008-01-10T11:00:00-05:00",
      "updated_at": "2008-01-10T11:00:00-05:00",
      "number": 1,
      "note": null,
      "token": "b1946ac92492d2347c6235b4d2611184",
      "gateway": "authorize_net",
      "test": false,
      "total_price": "598.94",
      "subtotal_price": "597.00",
      "total_weight": 0,
      "total_tax": "11.94",
      "taxes_included": false,
      "currency": "USD",
      "financial_status": "partially_refunded",
      "confirmed": true,
      "total_discounts": "10.00",
      "total_line_items_price": "597.00",
      "cart_token": "68778783ad298f1c80c3bafcddeea02f",
      "buyer_accepts_marketing": false,
      "name": "#1001",
      "referring_site": "http://www.otherexample.com",
      "landing_site": "http://www.example.com?source=abc",
      "cancelled_at": null,
      "cancel_reason": null,
      "total_price_usd": "598.94",
      "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
      "reference": "fhwdgads",
      "user_id": null,
      "location_id": null,
      "source_identifier": "fhwdgads",
      "source_url": null,
      "processed_at": "2008-01-10T11:00:00-05:00",
      "device_id": null,
      "phone": "+557734881234",
      "customer_locale": null,
      "app_id": null,
      "browser_ip": "0.0.0.0",
      "landing_site_ref": "abc",
      "order_number": 1001,
      "discount_applications": [
        {
          "type": "discount_code",
          "value": "10.0",
          "value_type": "percentage",
          "allocation_method": "across",
          "target_selection": "all",
          "target_type": "line_item",
          "code": "TENOFF"
        }
      ],
      "discount_codes": [
        {
          "code": "TENOFF",
          "amount": "10.00",
          "type": "percentage"
        }
      ],
      "note_attributes": [
        {
          "name": "custom engraving",
          "value": "Happy Birthday"
        },
        {
          "name": "colour",
          "value": "green"
        }
      ],
      "payment_gateway_names": [
        "bogus"
      ],
      "processing_method": "direct",
      "checkout_id": 901414060,
      "source_name": "web",
      "fulfillment_status": null,
      "tax_lines": [
        {
          "price": "11.94",
          "rate": 0.06,
          "title": "State Tax",
          "price_set": {
            "shop_money": {
              "amount": "11.94",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "11.94",
              "currency_code": "USD"
            }
          }
        }
      ],
      "tags": "",
      "contact_email": "bob.norman@hostmail.com",
      "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0acf4e9d8b8329fa3d1c041f79ae13a0",
      "presentment_currency": "USD",
      "total_line_items_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_discounts_set": {
        "shop_money": {
          "amount": "10.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "10.00",
          "currency_code": "USD"
        }
      },
      "total_shipping_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "subtotal_price_set": {
        "shop_money": {
          "amount": "597.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "597.00",
          "currency_code": "USD"
        }
      },
      "total_price_set": {
        "shop_money": {
          "amount": "598.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "598.94",
          "currency_code": "USD"
        }
      },
      "total_tax_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      },
      "admin_graphql_api_id": "gid://shopify/Order/450789469",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 518995019,
          "variant_id": 49148385,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008RED",
          "variant_title": "red",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - red",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        },
        {
          "id": 703073504,
          "variant_id": 457924702,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008BLACK",
          "variant_title": "black",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - black",
          "variant_inventory_management": "shopify",
          "properties": [],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ],
      "shipping_lines": [
        {
          "id": 369256396,
          "title": "Free Shipping",
          "price": "0.00",
          "code": "Free Shipping",
          "source": "shopify",
          "phone": null,
          "requested_fulfillment_service_id": null,
          "delivery_category": null,
          "carrier_identifier": null,
          "discounted_price": "0.00",
          "price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discounted_price_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "tax_lines": []
        }
      ],
      "billing_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "shipping_address": {
        "first_name": "Bob",
        "address1": "Chestnut Street 92",
        "phone": "555-625-1199",
        "city": "Louisville",
        "zip": "40202",
        "province": "Kentucky",
        "country": "United States",
        "last_name": "Norman",
        "address2": "",
        "company": null,
        "latitude": 45.41634,
        "longitude": -75.6868,
        "name": "Bob Norman",
        "country_code": "US",
        "province_code": "KY"
      },
      "fulfillments": [
        {
          "id": 255858046,
          "order_id": 450789469,
          "status": "failure",
          "created_at": "2019-10-16T16:01:19-04:00",
          "service": "manual",
          "updated_at": "2019-10-16T16:01:19-04:00",
          "tracking_company": null,
          "shipment_status": null,
          "location_id": 905684977,
          "tracking_number": "1Z2345",
          "tracking_numbers": [
            "1Z2345"
          ],
          "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
          "tracking_urls": [
            "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
          ],
          "receipt": {
            "testcase": true,
            "authorization": "123456"
          },
          "name": "#1001.0",
          "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
          "line_items": [
            {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          ]
        }
      ],
      "client_details": {
        "browser_ip": "0.0.0.0",
        "accept_language": null,
        "user_agent": null,
        "session_hash": null,
        "browser_width": null,
        "browser_height": null
      },
      "refunds": [
        {
          "id": 509562969,
          "order_id": 450789469,
          "created_at": "2019-10-16T16:01:19-04:00",
          "note": "it broke during shipping",
          "user_id": 799407056,
          "processed_at": "2019-10-16T16:01:19-04:00",
          "restock": true,
          "admin_graphql_api_id": "gid://shopify/Refund/509562969",
          "refund_line_items": [
            {
              "id": 104689539,
              "quantity": 1,
              "line_item_id": 703073504,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 703073504,
                "variant_id": 457924702,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008BLACK",
                "variant_title": "black",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - black",
                "variant_inventory_management": "shopify",
                "properties": [],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            },
            {
              "id": 709875399,
              "quantity": 1,
              "line_item_id": 466157049,
              "location_id": 487838322,
              "restock_type": "legacy_restock",
              "subtotal": 199.0,
              "total_tax": 3.98,
              "subtotal_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_tax_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              },
              "line_item": {
                "id": 466157049,
                "variant_id": 39072856,
                "title": "IPod Nano - 8gb",
                "quantity": 1,
                "sku": "IPOD2008GREEN",
                "variant_title": "green",
                "vendor": null,
                "fulfillment_service": "manual",
                "product_id": 632910392,
                "requires_shipping": true,
                "taxable": true,
                "gift_card": false,
                "name": "IPod Nano - 8gb - green",
                "variant_inventory_management": "shopify",
                "properties": [
                  {
                    "name": "Custom Engraving Front",
                    "value": "Happy Birthday"
                  },
                  {
                    "name": "Custom Engraving Back",
                    "value": "Merry Christmas"
                  }
                ],
                "product_exists": true,
                "fulfillable_quantity": 1,
                "grams": 200,
                "price": "199.00",
                "total_discount": "0.00",
                "fulfillment_status": null,
                "price_set": {
                  "shop_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "199.00",
                    "currency_code": "USD"
                  }
                },
                "total_discount_set": {
                  "shop_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "0.00",
                    "currency_code": "USD"
                  }
                },
                "discount_allocations": [],
                "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
                "tax_lines": [
                  {
                    "title": "State Tax",
                    "price": "3.98",
                    "rate": 0.06,
                    "price_set": {
                      "shop_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      },
                      "presentment_money": {
                        "amount": "3.98",
                        "currency_code": "USD"
                      }
                    }
                  }
                ]
              }
            }
          ],
          "transactions": [
            {
              "id": 179259969,
              "order_id": 450789469,
              "kind": "refund",
              "gateway": "bogus",
              "status": "success",
              "message": null,
              "created_at": "2005-08-05T12:59:12-04:00",
              "test": false,
              "authorization": "authorization-key",
              "location_id": null,
              "user_id": null,
              "parent_id": 801038806,
              "processed_at": "2005-08-05T12:59:12-04:00",
              "device_id": null,
              "receipt": {},
              "error_code": null,
              "source_name": "web",
              "amount": "209.00",
              "currency": "USD",
              "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
            }
          ],
          "order_adjustments": []
        }
      ],
      "payment_details": {
        "credit_card_bin": null,
        "avs_result_code": null,
        "cvv_result_code": null,
        "credit_card_number": "•••• •••• •••• 4242",
        "credit_card_company": "Visa"
      },
      "customer": {
        "id": 207119551,
        "email": "bob.norman@hostmail.com",
        "accepts_marketing": false,
        "created_at": "2019-10-16T16:01:19-04:00",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "first_name": "Bob",
        "last_name": "Norman",
        "orders_count": 1,
        "state": "disabled",
        "total_spent": "199.65",
        "last_order_id": 450789469,
        "note": null,
        "verified_email": true,
        "multipass_identifier": null,
        "tax_exempt": false,
        "phone": null,
        "tags": "",
        "last_order_name": "#1001",
        "currency": "USD",
        "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
        "marketing_opt_in_level": null,
        "tax_exemptions": [],
        "admin_graphql_api_id": "gid://shopify/Customer/207119551",
        "default_address": {
          "id": 207119551,
          "customer_id": 207119551,
          "first_name": null,
          "last_name": null,
          "company": null,
          "address1": "Chestnut Street 92",
          "address2": "",
          "city": "Louisville",
          "province": "Kentucky",
          "country": "United States",
          "zip": "40202",
          "phone": "555-625-1199",
          "name": "",
          "province_code": "KY",
          "country_code": "US",
          "country_name": "United States",
          "default": true
        }
      }
    }
  ]
}
GET /admin/api/2020-01/orders/#{order_id}.json
Retrieves a specific order
fields

Retrieve only certain fields, specified by a comma-separated list of fields names.

Retrieve a single order

GET /admin/api/2020-01/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2008-01-10T11:00:00-05:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ae8af92349ee3e1dee8b24eef131fbea",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Get only particular fields

GET /admin/api/2020-01/orders/#{order_id}.json?fields=id,line_items,name,total_price
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "total_price": "598.94",
    "name": "#1001",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ]
  }
}
GET /admin/api/2020-01/orders/count.json
Retrieves an order count
created_at_min

Count orders created after date (format: 2014-04-25T16:15:47-04:00).

created_at_max

Count orders created before date (format: 2014-04-25T16:15:47-04:00).

updated_at_min

Count orders last updated after date (format: 2014-04-25T16:15:47-04:00).

updated_at_max

Count orders last updated before date (format: 2014-04-25T16:15:47-04:00).

status

Count orders of a given status.

(default: open)
  • open: Count open orders.
  • closed: Count closed orders.
  • any: Count orders of any status.
financial_status

Count orders of a given financial status.

(default: any)
  • authorized: Count authorized orders.
  • pending: Count pending orders.
  • paid: Count paid orders.
  • refunded: Count refunded orders.
  • voided: Count voided orders.
  • any: Count orders of any financial status.
fulfillment_status

Filter orders by their fulfillment status.

(default: any)
  • shipped: Show orders that have been shipped. Returns orders with fulfillment_status of fulfilled.
  • partial: Show partially shipped orders.
  • unshipped: Show orders that have not yet been shipped. Returns orders with fulfillment_status of null.
  • any: Show orders of any fulfillment status.
  • unfulfilled: Returns orders with fulfillment_status of null or partial.

Count all orders

GET /admin/api/2020-01/orders/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 1
}

Count orders that have authorized payments ready to be captured

GET /admin/api/2020-01/orders/count.json?financial_status=authorized
View Response
HTTP/1.1 200 OK
{
  "count": 1
}
POST /admin/api/2020-01/orders/#{order_id}/close.json
Closes an order

Close an order

POST /admin/api/2020-01/orders/#{order_id}/close.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": "2019-10-16T16:05:17-04:00",
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:17-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2e921b708a09b041a65ffb02d4d1be52",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2020-01/orders/#{order_id}/open.json
Re-opens a closed order

Re-open a closed order

POST /admin/api/2020-01/orders/#{order_id}/open.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:19-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f370264649269e90e395c9294bd4b358",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
POST /admin/api/2020-01/orders/#{order_id}/cancel.json
Cancels an order. Orders that have a fulfillment object can't be canceled.
amount

The amount to refund. If set, Shopify attempts to void or refund the payment, depending on its status.

currency

The currency of the refund that's issued when the order is canceled. Required for multi-currency orders whenever the amount property is provided.

restock
deprecated

Whether to restock refunded items back to your store's inventory.

(default: false)
reason

The reason for the order cancellation. Valid values: customer, inventory, fraud, declined, and other.)

(default: other)
email

Whether to send an email to the customer notifying them of the cancellation.

(default: false)
refund

The refund transactions to perform. Required for some more complex refund situations. For more information, see the Refund API.

Cancel an order

POST /admin/api/2020-01/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2008-01-10T11:00:00-05:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=341cf1d04694165a4cd345d0b6b81954",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Cancel and refund an order using the amount property

POST /admin/api/2020-01/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "10.00",
  "currency": "USD"
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:24-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "bogus",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=382805203a96d6c29ca7600046ba6290",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361468,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:24-04:00",
      "note": null,
      "user_id": null,
      "processed_at": "2019-10-16T16:05:24-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361468",
      "refund_line_items": [
        {
          "id": 1058498313,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498314,
          "quantity": 1,
          "line_item_id": 518995019,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 518995019,
            "variant_id": 49148385,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008RED",
            "variant_title": "red",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - red",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 1058498315,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844705,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:24-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844704,
          "processed_at": "2019-10-16T16:05:24-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844705"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

When an order has multiple refundable transactions, refunding an amount less than its net payment without a refund property fails with an error

POST /admin/api/2020-01/orders/#{order_id}/cancel.json
{
  "note": "Broke in shipping",
  "amount": "109.00",
  "currency": "USD"
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:27-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=a64beb6670f1295ff7ff08c2f06e132b",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 1,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Refund parameter required to process refund"
}

Cancel and refund an order using the refund property

POST /admin/api/2020-01/orders/#{order_id}/cancel.json
{
  "refund": {
    "note": "Customer made a mistake",
    "shipping": {
      "full_refund": true
    },
    "refund_line_items": [
      {
        "line_item_id": 466157049,
        "quantity": 1,
        "restock_type": "cancel",
        "location_id": 48752903
      }
    ],
    "transactions": [
      {
        "parent_id": 1072844710,
        "amount": "10.00",
        "kind": "refund",
        "gateway": "bogus"
      },
      {
        "parent_id": 1072844711,
        "amount": "100.00",
        "kind": "refund",
        "gateway": "gift_card"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:32-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "gift_card",
  "test": true,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus",
    "gift_card"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b714067bde79ce7e56beddd5c225a955",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "failure",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "tracking_company": null,
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": null,
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 929361469,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:05:32-04:00",
      "note": "Customer made a mistake",
      "user_id": null,
      "processed_at": "2019-10-16T16:05:32-04:00",
      "restock": false,
      "admin_graphql_api_id": "gid://shopify/Refund/929361469",
      "refund_line_items": [
        {
          "id": 1058498316,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": null,
          "restock_type": "no_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 1072844712,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": "Bogus Gateway: Forced success",
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": true,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844710,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "755357713",
          "amount": "10.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844712"
        },
        {
          "id": 1072844713,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "gift_card",
          "status": "success",
          "message": null,
          "created_at": "2019-10-16T16:05:32-04:00",
          "test": false,
          "authorization": null,
          "location_id": null,
          "user_id": null,
          "parent_id": 1072844711,
          "processed_at": "2019-10-16T16:05:32-04:00",
          "device_id": null,
          "receipt": {
            "gift_card_id": 48394658,
            "gift_card_last_characters": "0d0d"
          },
          "error_code": null,
          "source_name": "755357713",
          "amount": "100.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/1072844713"
        }
      ],
      "order_adjustments": [
        {
          "id": 1030976845,
          "order_id": 450789469,
          "refund_id": 929361469,
          "amount": "92.98",
          "tax_amount": "0.00",
          "kind": "refund_discrepancy",
          "reason": "Refund discrepancy",
          "amount_set": {
            "shop_money": {
              "amount": "92.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "92.98",
              "currency_code": "USD"
            }
          },
          "tax_amount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "notice": "Order has been canceled"
}

Canceling an order that has fulfillments fails with an error

POST /admin/api/2020-01/orders/#{order_id}/cancel.json
{
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "order": {
  "id": 450789469,
  "email": "bob.norman@hostmail.com",
  "closed_at": null,
  "created_at": "2008-01-10T11:00:00-05:00",
  "updated_at": "2019-10-16T16:05:33-04:00",
  "number": 1,
  "note": null,
  "token": "b1946ac92492d2347c6235b4d2611184",
  "gateway": "authorize_net",
  "test": false,
  "total_price": "598.94",
  "subtotal_price": "597.00",
  "total_weight": 0,
  "total_tax": "11.94",
  "taxes_included": false,
  "currency": "USD",
  "financial_status": "partially_refunded",
  "confirmed": true,
  "total_discounts": "10.00",
  "total_line_items_price": "597.00",
  "cart_token": "68778783ad298f1c80c3bafcddeea02f",
  "buyer_accepts_marketing": false,
  "name": "#1001",
  "referring_site": "http://www.otherexample.com",
  "landing_site": "http://www.example.com?source=abc",
  "cancelled_at": null,
  "cancel_reason": null,
  "total_price_usd": "598.94",
  "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
  "reference": "fhwdgads",
  "user_id": null,
  "location_id": null,
  "source_identifier": "fhwdgads",
  "source_url": null,
  "processed_at": "2008-01-10T11:00:00-05:00",
  "device_id": null,
  "phone": "+557734881234",
  "customer_locale": null,
  "app_id": null,
  "browser_ip": "0.0.0.0",
  "landing_site_ref": "abc",
  "order_number": 1001,
  "discount_applications": [
    {
      "type": "discount_code",
      "value": "10.0",
      "value_type": "percentage",
      "allocation_method": "across",
      "target_selection": "all",
      "target_type": "line_item",
      "code": "TENOFF"
    }
  ],
  "discount_codes": [
    {
      "code": "TENOFF",
      "amount": "10.00",
      "type": "percentage"
    }
  ],
  "note_attributes": [
    {
      "name": "custom engraving",
      "value": "Happy Birthday"
    },
    {
      "name": "colour",
      "value": "green"
    }
  ],
  "payment_gateway_names": [
    "bogus"
  ],
  "processing_method": "direct",
  "checkout_id": 901414060,
  "source_name": "web",
  "fulfillment_status": null,
  "tax_lines": [
    {
      "price": "11.94",
      "rate": 0.06,
      "title": "State Tax",
      "price_set": {
        "shop_money": {
          "amount": "11.94",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "11.94",
          "currency_code": "USD"
        }
      }
    }
  ],
  "tags": "",
  "contact_email": "bob.norman@hostmail.com",
  "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=2995df0cbbf011b1b9a4be120b578ba6",
  "presentment_currency": "USD",
  "total_line_items_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_discounts_set": {
    "shop_money": {
      "amount": "10.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "10.00",
      "currency_code": "USD"
    }
  },
  "total_shipping_price_set": {
    "shop_money": {
      "amount": "0.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "0.00",
      "currency_code": "USD"
    }
  },
  "subtotal_price_set": {
    "shop_money": {
      "amount": "597.00",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "597.00",
      "currency_code": "USD"
    }
  },
  "total_price_set": {
    "shop_money": {
      "amount": "598.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "598.94",
      "currency_code": "USD"
    }
  },
  "total_tax_set": {
    "shop_money": {
      "amount": "11.94",
      "currency_code": "USD"
    },
    "presentment_money": {
      "amount": "11.94",
      "currency_code": "USD"
    }
  },
  "admin_graphql_api_id": "gid://shopify/Order/450789469",
  "line_items": [
    {
      "id": 466157049,
      "variant_id": 39072856,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008GREEN",
      "variant_title": "green",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - green",
      "variant_inventory_management": "shopify",
      "properties": [
        {
          "name": "Custom Engraving Front",
          "value": "Happy Birthday"
        },
        {
          "name": "Custom Engraving Back",
          "value": "Merry Christmas"
        }
      ],
      "product_exists": true,
      "fulfillable_quantity": 0,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": "fulfilled",
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 518995019,
      "variant_id": 49148385,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008RED",
      "variant_title": "red",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - red",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    },
    {
      "id": 703073504,
      "variant_id": 457924702,
      "title": "IPod Nano - 8gb",
      "quantity": 1,
      "sku": "IPOD2008BLACK",
      "variant_title": "black",
      "vendor": null,
      "fulfillment_service": "manual",
      "product_id": 632910392,
      "requires_shipping": true,
      "taxable": true,
      "gift_card": false,
      "name": "IPod Nano - 8gb - black",
      "variant_inventory_management": "shopify",
      "properties": [],
      "product_exists": true,
      "fulfillable_quantity": 1,
      "grams": 200,
      "price": "199.00",
      "total_discount": "0.00",
      "fulfillment_status": null,
      "price_set": {
        "shop_money": {
          "amount": "199.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "199.00",
          "currency_code": "USD"
        }
      },
      "total_discount_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
      "tax_lines": [
        {
          "title": "State Tax",
          "price": "3.98",
          "rate": 0.06,
          "price_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          }
        }
      ]
    }
  ],
  "shipping_lines": [
    {
      "id": 369256396,
      "title": "Free Shipping",
      "price": "0.00",
      "code": "Free Shipping",
      "source": "shopify",
      "phone": null,
      "requested_fulfillment_service_id": null,
      "delivery_category": null,
      "carrier_identifier": null,
      "discounted_price": "0.00",
      "price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discounted_price_set": {
        "shop_money": {
          "amount": "0.00",
          "currency_code": "USD"
        },
        "presentment_money": {
          "amount": "0.00",
          "currency_code": "USD"
        }
      },
      "discount_allocations": [],
      "tax_lines": []
    }
  ],
  "billing_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "shipping_address": {
    "first_name": "Bob",
    "address1": "Chestnut Street 92",
    "phone": "555-625-1199",
    "city": "Louisville",
    "zip": "40202",
    "province": "Kentucky",
    "country": "United States",
    "last_name": "Norman",
    "address2": "",
    "company": null,
    "latitude": 45.41634,
    "longitude": -75.6868,
    "name": "Bob Norman",
    "country_code": "US",
    "province_code": "KY"
  },
  "fulfillments": [
    {
      "id": 255858046,
      "order_id": 450789469,
      "status": "success",
      "created_at": "2019-10-16T16:01:19-04:00",
      "service": "manual",
      "updated_at": "2019-10-16T16:05:33-04:00",
      "tracking_company": "UPS",
      "shipment_status": null,
      "location_id": 905684977,
      "tracking_number": "1Z2345",
      "tracking_numbers": [
        "1Z2345"
      ],
      "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
      "tracking_urls": [
        "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
      ],
      "receipt": {
        "testcase": true,
        "authorization": "123456"
      },
      "name": "#1001.0",
      "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
      "line_items": [
        {
          "id": 466157049,
          "variant_id": 39072856,
          "title": "IPod Nano - 8gb",
          "quantity": 1,
          "sku": "IPOD2008GREEN",
          "variant_title": "green",
          "vendor": null,
          "fulfillment_service": "manual",
          "product_id": 632910392,
          "requires_shipping": true,
          "taxable": true,
          "gift_card": false,
          "name": "IPod Nano - 8gb - green",
          "variant_inventory_management": "shopify",
          "properties": [
            {
              "name": "Custom Engraving Front",
              "value": "Happy Birthday"
            },
            {
              "name": "Custom Engraving Back",
              "value": "Merry Christmas"
            }
          ],
          "product_exists": true,
          "fulfillable_quantity": 0,
          "grams": 200,
          "price": "199.00",
          "total_discount": "0.00",
          "fulfillment_status": "fulfilled",
          "price_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_discount_set": {
            "shop_money": {
              "amount": "0.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "0.00",
              "currency_code": "USD"
            }
          },
          "discount_allocations": [],
          "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
          "tax_lines": [
            {
              "title": "State Tax",
              "price": "3.98",
              "rate": 0.06,
              "price_set": {
                "shop_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "3.98",
                  "currency_code": "USD"
                }
              }
            }
          ]
        }
      ]
    }
  ],
  "client_details": {
    "browser_ip": "0.0.0.0",
    "accept_language": null,
    "user_agent": null,
    "session_hash": null,
    "browser_width": null,
    "browser_height": null
  },
  "refunds": [
    {
      "id": 509562969,
      "order_id": 450789469,
      "created_at": "2019-10-16T16:01:19-04:00",
      "note": "it broke during shipping",
      "user_id": 799407056,
      "processed_at": "2019-10-16T16:01:19-04:00",
      "restock": true,
      "admin_graphql_api_id": "gid://shopify/Refund/509562969",
      "refund_line_items": [
        {
          "id": 104689539,
          "quantity": 1,
          "line_item_id": 703073504,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 703073504,
            "variant_id": 457924702,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "black",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        },
        {
          "id": 709875399,
          "quantity": 1,
          "line_item_id": 466157049,
          "location_id": 487838322,
          "restock_type": "legacy_restock",
          "subtotal": 199.0,
          "total_tax": 3.98,
          "subtotal_set": {
            "shop_money": {
              "amount": "199.00",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "199.00",
              "currency_code": "USD"
            }
          },
          "total_tax_set": {
            "shop_money": {
              "amount": "3.98",
              "currency_code": "USD"
            },
            "presentment_money": {
              "amount": "3.98",
              "currency_code": "USD"
            }
          },
          "line_item": {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        }
      ],
      "transactions": [
        {
          "id": 179259969,
          "order_id": 450789469,
          "kind": "refund",
          "gateway": "bogus",
          "status": "success",
          "message": null,
          "created_at": "2005-08-05T12:59:12-04:00",
          "test": false,
          "authorization": "authorization-key",
          "location_id": null,
          "user_id": null,
          "parent_id": 801038806,
          "processed_at": "2005-08-05T12:59:12-04:00",
          "device_id": null,
          "receipt": {},
          "error_code": null,
          "source_name": "web",
          "amount": "209.00",
          "currency": "USD",
          "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
        }
      ],
      "order_adjustments": []
    }
  ],
  "payment_details": {
    "credit_card_bin": null,
    "avs_result_code": null,
    "cvv_result_code": null,
    "credit_card_number": "•••• •••• •••• 4242",
    "credit_card_company": "Visa"
  },
  "customer": {
    "id": 207119551,
    "email": "bob.norman@hostmail.com",
    "accepts_marketing": false,
    "created_at": "2019-10-16T16:01:19-04:00",
    "updated_at": "2019-10-16T16:01:19-04:00",
    "first_name": "Bob",
    "last_name": "Norman",
    "orders_count": 1,
    "state": "disabled",
    "total_spent": "199.65",
    "last_order_id": 450789469,
    "note": null,
    "verified_email": true,
    "multipass_identifier": null,
    "tax_exempt": false,
    "phone": null,
    "tags": "",
    "last_order_name": "#1001",
    "currency": "USD",
    "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
    "marketing_opt_in_level": null,
    "tax_exemptions": [],
    "admin_graphql_api_id": "gid://shopify/Customer/207119551",
    "default_address": {
      "id": 207119551,
      "customer_id": 207119551,
      "first_name": null,
      "last_name": null,
      "company": null,
      "address1": "Chestnut Street 92",
      "address2": "",
      "city": "Louisville",
      "province": "Kentucky",
      "country": "United States",
      "zip": "40202",
      "phone": "555-625-1199",
      "name": "",
      "province_code": "KY",
      "country_code": "US",
      "country_name": "United States",
      "default": true
    }
  }
},
  "error": "Cannot cancel a paid and fulfilled order"
}
POST /admin/api/2020-01/orders.json

Creates an order. By default, product inventory is not claimed.

When you create an order, you can include the following option parameters in the body of the request:

  • inventory_behaviour: The behaviour to use when updating inventory. (default: bypass)
    • bypass: Do not claim inventory.
    • decrement_ignoring_policy: Ignore the product's inventory policy and claim inventory.
    • decrement_obeying_policy: Follow the product's inventory policy and claim inventory, if possible.
  • send_receipt: Whether to send an order confirmation to the customer.
  • send_fulfillment_receipt: Whether to send a shipping confirmation to the customer.

Create a simple order with only a product variant ID

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459985,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:35-04:00",
    "updated_at": "2019-10-16T16:05:35-04:00",
    "number": 2,
    "note": null,
    "token": "8d9822b56c8bac57b659e0356c17130f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:35-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/8d9822b56c8bac57b659e0356c17130f/authenticate?key=78077388d47f4ce5286404667593b472",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459985",
    "line_items": [
      {
        "id": 1071823193,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823193",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create a simple order, sending an order confirmation and a shipping confirmation to the customer

POST /admin/api/2020-01/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "send_receipt": true,
    "send_fulfillment_receipt": true,
    "line_items": [
      {
        "variant_id": 457924702,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459986,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:36-04:00",
    "updated_at": "2019-10-16T16:05:36-04:00",
    "number": 2,
    "note": null,
    "token": "099ade3f1a08fd25e238d8cd0c7b21cc",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:36-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/099ade3f1a08fd25e238d8cd0c7b21cc/authenticate?key=939e30cc5de654fa267acb4f84d1ce53",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459986",
    "line_items": [
      {
        "id": 1071823194,
        "variant_id": 457924702,
        "title": "IPod Nano - 8GB",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8GB - Black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": "fulfilled",
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782937,
        "order_id": 1073459986,
        "status": "success",
        "created_at": "2019-10-16T16:05:36-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:05:36-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 487838322,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782937",
        "line_items": [
          {
            "id": 1071823194,
            "variant_id": 457924702,
            "title": "IPod Nano - 8GB",
            "quantity": 1,
            "sku": "IPOD2008BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8GB - Black",
            "variant_inventory_management": "shopify",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": "fulfilled",
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823194",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339486,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:36-04:00",
      "updated_at": "2019-10-16T16:05:36-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459986,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:36-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339486"
    }
  }
}

Create a simple order without sending an order receipt or a fulfillment receipt

POST /admin/api/2020-01/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459987,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:37-04:00",
    "updated_at": "2019-10-16T16:05:37-04:00",
    "number": 2,
    "note": null,
    "token": "473abaf7f739a5f62e92101d68b6ba1f",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:37-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/473abaf7f739a5f62e92101d68b6ba1f/authenticate?key=aba982bdcb58f9f664a65577a33a61ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459987",
    "line_items": [
      {
        "id": 1071823195,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782938,
        "order_id": 1073459987,
        "status": "pending",
        "created_at": "2019-10-16T16:05:38-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:38-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 48752903,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782938",
        "line_items": [
          {
            "id": 1071823195,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823195",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339487,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:37-04:00",
      "updated_at": "2019-10-16T16:05:38-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459987,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:38-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339487"
    }
  }
}

Create a simple order and fulfill it

POST /admin/api/2020-01/orders.json
{
  "order": {
    "email": "foo@example.com",
    "fulfillment_status": "fulfilled",
    "fulfillments": [
      {
        "location_id": 905684977
      }
    ],
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459988,
    "email": "foo@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:39-04:00",
    "updated_at": "2019-10-16T16:05:39-04:00",
    "number": 2,
    "note": null,
    "token": "596f82e63339494af345c9d2c0028d1a",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:39-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": "fulfilled",
    "tax_lines": [],
    "tags": "",
    "contact_email": "foo@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/596f82e63339494af345c9d2c0028d1a/authenticate?key=f654698e272d8a900369dbe613a14b79",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459988",
    "line_items": [
      {
        "id": 1071823196,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 0,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [
      {
        "id": 1022782939,
        "order_id": 1073459988,
        "status": "pending",
        "created_at": "2019-10-16T16:05:39-04:00",
        "service": "shipwire-app",
        "updated_at": "2019-10-16T16:05:39-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": null,
        "tracking_numbers": [],
        "tracking_url": null,
        "tracking_urls": [],
        "receipt": {},
        "name": "#1002.1",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/1022782939",
        "line_items": [
          {
            "id": 1071823196,
            "variant_id": 447654529,
            "title": "IPod Touch 8GB",
            "quantity": 1,
            "sku": "IPOD2009BLACK",
            "variant_title": "Black",
            "vendor": "Apple",
            "fulfillment_service": "shipwire-app",
            "product_id": 921728736,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Touch 8GB - Black",
            "variant_inventory_management": "shipwire-app",
            "properties": [],
            "product_exists": true,
            "fulfillable_quantity": 0,
            "grams": 567,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/1071823196",
            "tax_lines": []
          }
        ]
      }
    ],
    "refunds": [],
    "customer": {
      "id": 1073339488,
      "email": "foo@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:39-04:00",
      "updated_at": "2019-10-16T16:05:39-04:00",
      "first_name": null,
      "last_name": null,
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459988,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:39-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339488"
    }
  }
}

Create a comprehensive order

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Big Brown Bear Boots",
        "price": 74.99,
        "grams": "1300",
        "quantity": 3,
        "tax_lines": [
          {
            "price": 13.5,
            "rate": 0.06,
            "title": "State tax"
          }
        ]
      }
    ],
    "transactions": [
      {
        "kind": "sale",
        "status": "success",
        "amount": 238.47
      }
    ],
    "total_tax": 13.5,
    "currency": "EUR"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459989,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:40-04:00",
    "updated_at": "2019-10-16T16:05:40-04:00",
    "number": 2,
    "note": null,
    "token": "79b48501190269e07b527a38c56f4fd7",
    "gateway": "",
    "test": false,
    "total_price": "238.47",
    "subtotal_price": "224.97",
    "total_weight": 0,
    "total_tax": "13.50",
    "taxes_included": false,
    "currency": "EUR",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "224.97",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "340.54",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:40-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "13.50",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "13.50",
            "currency_code": "EUR"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/79b48501190269e07b527a38c56f4fd7/authenticate?key=39248e7aeafbe37e41b668ee71c76d9e",
    "presentment_currency": "EUR",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "EUR"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "224.97",
        "currency_code": "EUR"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "238.47",
        "currency_code": "EUR"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      },
      "presentment_money": {
        "amount": "13.50",
        "currency_code": "EUR"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459989",
    "line_items": [
      {
        "id": 1071823197,
        "variant_id": null,
        "title": "Big Brown Bear Boots",
        "quantity": 3,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Big Brown Bear Boots",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 3,
        "grams": 1300,
        "price": "74.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "74.99",
            "currency_code": "EUR"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "EUR"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823197",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "13.50",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              },
              "presentment_money": {
                "amount": "13.50",
                "currency_code": "EUR"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Create an order with tax lines split across taxable line items

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459990,
    "email": "",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:41-04:00",
    "updated_at": "2019-10-16T16:05:41-04:00",
    "number": 2,
    "note": null,
    "token": "a04a79891455ebbd7ff38c68e1d313e8",
    "gateway": "",
    "test": false,
    "total_price": "270.37",
    "subtotal_price": "255.92",
    "total_weight": 0,
    "total_tax": "14.45",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "255.92",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "270.37",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:41-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "10.20",
        "rate": 0.06,
        "title": "State tax",
        "price_set": {
          "shop_money": {
            "amount": "10.20",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "10.20",
            "currency_code": "USD"
          }
        }
      },
      {
        "price": "4.25",
        "rate": 0.025,
        "title": "County tax",
        "price_set": {
          "shop_money": {
            "amount": "4.25",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "4.25",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": null,
    "order_status_url": "https://apple.myshopify.com/690933842/orders/a04a79891455ebbd7ff38c68e1d313e8/authenticate?key=c1b2fe9403c190ac3b7a2cbd6d0ec839",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "255.92",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "255.92",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "270.37",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "270.37",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "14.45",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "14.45",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459990",
    "line_items": [
      {
        "id": 1071823198,
        "variant_id": null,
        "title": "Red Leather Coat",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Red Leather Coat",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 1700,
        "price": "129.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "129.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "129.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823198",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "7.81",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "7.81",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "7.81",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "3.26",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "3.26",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.26",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 1071823199,
        "variant_id": null,
        "title": "Blue Suede Shoes",
        "quantity": 1,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": false,
        "gift_card": false,
        "name": "Blue Suede Shoes",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 1,
        "grams": 750,
        "price": "85.95",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "85.95",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "85.95",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823199",
        "tax_lines": []
      },
      {
        "id": 1071823200,
        "variant_id": null,
        "title": "Raspberry Beret",
        "quantity": 2,
        "sku": null,
        "variant_title": null,
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": null,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "Raspberry Beret",
        "variant_inventory_management": null,
        "properties": [],
        "product_exists": false,
        "fulfillable_quantity": 2,
        "grams": 320,
        "price": "19.99",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "19.99",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "19.99",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823200",
        "tax_lines": [
          {
            "title": "State tax",
            "price": "2.39",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "2.39",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "2.39",
                "currency_code": "USD"
              }
            }
          },
          {
            "title": "County tax",
            "price": "0.99",
            "rate": 0.025,
            "price_set": {
              "shop_money": {
                "amount": "0.99",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.99",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": []
  }
}

Creating an order with tax lines both on line items and on the order fails and returns an error

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "title": "Clicky Keyboard",
        "price": 99.99,
        "grams": "600",
        "quantity": 1,
        "tax_lines": [
          {
            "price": 1.0,
            "rate": 0.01,
            "title": "Keyboard tax"
          }
        ]
      }
    ],
    "tax_lines": [
      {
        "price": 6.0,
        "rate": 0.06,
        "title": "State tax"
      }
    ]
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "order": [
      "Tax lines must be associated with either order or line item but not both"
    ]
  }
}

Create a pending order with an existing customer

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "id": 207119551
    },
    "financial_status": "pending"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459991,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:43-04:00",
    "updated_at": "2019-10-16T16:05:43-04:00",
    "number": 2,
    "note": null,
    "token": "f08815fc24c65fed5b3fbf254cb3a172",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "pending",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:43-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/f08815fc24c65fed5b3fbf254cb3a172/authenticate?key=c662919911dd8c19ddca21c9d1cccebf",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459991",
    "line_items": [
      {
        "id": 1071823201,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823201",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:05:43-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 2,
      "state": "disabled",
      "total_spent": "398.65",
      "last_order_id": 1073459991,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Create a partially paid order with a new customer and addresses

POST /admin/api/2020-01/orders.json
{
  "order": {
    "line_items": [
      {
        "variant_id": 447654529,
        "quantity": 1
      }
    ],
    "customer": {
      "first_name": "Paul",
      "last_name": "Norman",
      "email": "paul.norman@example.com"
    },
    "billing_address": {
      "first_name": "John",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Smith",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "province": "Ontario",
      "country": "Canada",
      "zip": "K2P 1L4"
    },
    "email": "jane@example.com",
    "transactions": [
      {
        "kind": "authorization",
        "status": "success",
        "amount": 50.0
      }
    ],
    "financial_status": "partially_paid"
  }
}
View Response
HTTP/1.1 201 Created
{
  "order": {
    "id": 1073459992,
    "email": "jane@example.com",
    "closed_at": null,
    "created_at": "2019-10-16T16:05:44-04:00",
    "updated_at": "2019-10-16T16:05:44-04:00",
    "number": 2,
    "note": null,
    "token": "e925c8aed256267e9476ceb5b18477ca",
    "gateway": "",
    "test": false,
    "total_price": "199.00",
    "subtotal_price": "199.00",
    "total_weight": 0,
    "total_tax": "0.00",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_paid",
    "confirmed": true,
    "total_discounts": "0.00",
    "total_line_items_price": "199.00",
    "cart_token": null,
    "buyer_accepts_marketing": false,
    "name": "#1002",
    "referring_site": null,
    "landing_site": null,
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "199.00",
    "checkout_token": null,
    "reference": null,
    "user_id": null,
    "location_id": null,
    "source_identifier": null,
    "source_url": null,
    "processed_at": "2019-10-16T16:05:44-04:00",
    "device_id": null,
    "phone": null,
    "customer_locale": null,
    "app_id": 755357713,
    "browser_ip": null,
    "landing_site_ref": null,
    "order_number": 1002,
    "discount_applications": [],
    "discount_codes": [],
    "note_attributes": [],
    "payment_gateway_names": [
      ""
    ],
    "processing_method": "",
    "checkout_id": null,
    "source_name": "755357713",
    "fulfillment_status": null,
    "tax_lines": [],
    "tags": "",
    "contact_email": "jane@example.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/e925c8aed256267e9476ceb5b18477ca/authenticate?key=7e1d0cf8e8071dacaf924b3e3f6cfc5a",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "199.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "199.00",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/1073459992",
    "line_items": [
      {
        "id": 1071823202,
        "variant_id": 447654529,
        "title": "IPod Touch 8GB",
        "quantity": 1,
        "sku": "IPOD2009BLACK",
        "variant_title": "Black",
        "vendor": "Apple",
        "fulfillment_service": "shipwire-app",
        "product_id": 921728736,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Touch 8GB - Black",
        "variant_inventory_management": "shipwire-app",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 567,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/1071823202",
        "tax_lines": []
      }
    ],
    "shipping_lines": [],
    "billing_address": {
      "first_name": "John",
      "address1": "123 Fake Street",
      "phone": "555-555-5555",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "John Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "shipping_address": {
      "first_name": "Jane",
      "address1": "123 Fake Street",
      "phone": "777-777-7777",
      "city": "Fakecity",
      "zip": "K2P 1L4",
      "province": "Ontario",
      "country": "Canada",
      "last_name": "Smith",
      "address2": null,
      "company": null,
      "latitude": null,
      "longitude": null,
      "name": "Jane Smith",
      "country_code": "CA",
      "province_code": "ON"
    },
    "fulfillments": [],
    "refunds": [],
    "customer": {
      "id": 1073339489,
      "email": "paul.norman@example.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:05:44-04:00",
      "updated_at": "2019-10-16T16:05:44-04:00",
      "first_name": "John",
      "last_name": "Smith",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.00",
      "last_order_id": 1073459992,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1002",
      "currency": "USD",
      "accepts_marketing_updated_at": "2019-10-16T16:05:44-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/1073339489",
      "default_address": {
        "id": 1053317336,
        "customer_id": 1073339489,
        "first_name": "Jane",
        "last_name": "Smith",
        "company": null,
        "address1": "123 Fake Street",
        "address2": null,
        "city": "Fakecity",
        "province": "Ontario",
        "country": "Canada",
        "zip": "K2P 1L4",
        "phone": "777-777-7777",
        "name": "Jane Smith",
        "province_code": "ON",
        "country_code": "CA",
        "country_name": "Canada",
        "default": true
      }
    }
  }
}
PUT /admin/api/2020-01/orders/#{order_id}.json
Updates an order

Add a note to order

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note": "Customer contacted us about a custom engraving on this iPod"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:45-04:00",
    "number": 1,
    "note": "Customer contacted us about a custom engraving on this iPod",
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=8155cfa3bbceabbb1d0edef7b195dd64",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add note attributes to an order

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:46-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "colour",
        "value": "red"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=15010976f579ace96dd8112e57164c66",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's email address

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "a-different@email.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:47-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "a-different@email.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=7c1a0dd8ce96d5f955a323ac1373116f",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change an order's phone number

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "phone": "+15145556677"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:48-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+15145556677",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=b9aa533284a9a714082f46efa945d1aa",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Change whether the buyer accepts marketing

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "buyer_accepts_marketing": true
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:49-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": true,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ffda8ed25578813749d8dd508c787062",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Add a metafield to an order

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:50-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=0aca457a2b3b052c74d6319757af3678",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Update the shipping address of an order

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "shipping_address": {
      "address1": "123 Ship Street",
      "city": "Shipsville"
    }
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:51-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=ef6881713147de7c5275468ecce51482",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "123 Ship Street",
      "phone": "555-625-1199",
      "city": "Shipsville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}

Remove the customer from an order

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "customer": null
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=f26ab2ae733ac41257b8627419d758ee",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    }
  }
}

Update an order's tags

PUT /admin/api/2020-01/orders/#{order_id}.json
{
  "order": {
    "id": 450789469,
    "tags": "External, Inbound, Outbound"
  }
}
View Response
HTTP/1.1 200 OK
{
  "order": {
    "id": 450789469,
    "email": "bob.norman@hostmail.com",
    "closed_at": null,
    "created_at": "2008-01-10T11:00:00-05:00",
    "updated_at": "2019-10-16T16:05:52-04:00",
    "number": 1,
    "note": null,
    "token": "b1946ac92492d2347c6235b4d2611184",
    "gateway": "authorize_net",
    "test": false,
    "total_price": "598.94",
    "subtotal_price": "597.00",
    "total_weight": 0,
    "total_tax": "11.94",
    "taxes_included": false,
    "currency": "USD",
    "financial_status": "partially_refunded",
    "confirmed": true,
    "total_discounts": "10.00",
    "total_line_items_price": "597.00",
    "cart_token": "68778783ad298f1c80c3bafcddeea02f",
    "buyer_accepts_marketing": false,
    "name": "#1001",
    "referring_site": "http://www.otherexample.com",
    "landing_site": "http://www.example.com?source=abc",
    "cancelled_at": null,
    "cancel_reason": null,
    "total_price_usd": "598.94",
    "checkout_token": "bd5a8aa1ecd019dd3520ff791ee3a24c",
    "reference": "fhwdgads",
    "user_id": null,
    "location_id": null,
    "source_identifier": "fhwdgads",
    "source_url": null,
    "processed_at": "2008-01-10T11:00:00-05:00",
    "device_id": null,
    "phone": "+557734881234",
    "customer_locale": null,
    "app_id": null,
    "browser_ip": "0.0.0.0",
    "landing_site_ref": "abc",
    "order_number": 1001,
    "discount_applications": [
      {
        "type": "discount_code",
        "value": "10.0",
        "value_type": "percentage",
        "allocation_method": "across",
        "target_selection": "all",
        "target_type": "line_item",
        "code": "TENOFF"
      }
    ],
    "discount_codes": [
      {
        "code": "TENOFF",
        "amount": "10.00",
        "type": "percentage"
      }
    ],
    "note_attributes": [
      {
        "name": "custom engraving",
        "value": "Happy Birthday"
      },
      {
        "name": "colour",
        "value": "green"
      }
    ],
    "payment_gateway_names": [
      "bogus"
    ],
    "processing_method": "direct",
    "checkout_id": 901414060,
    "source_name": "web",
    "fulfillment_status": null,
    "tax_lines": [
      {
        "price": "11.94",
        "rate": 0.06,
        "title": "State Tax",
        "price_set": {
          "shop_money": {
            "amount": "11.94",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "11.94",
            "currency_code": "USD"
          }
        }
      }
    ],
    "tags": "External, Inbound, Outbound",
    "contact_email": "bob.norman@hostmail.com",
    "order_status_url": "https://apple.myshopify.com/690933842/orders/b1946ac92492d2347c6235b4d2611184/authenticate?key=bc254a43d3744cdfa1ead8a308a26b8c",
    "presentment_currency": "USD",
    "total_line_items_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_discounts_set": {
      "shop_money": {
        "amount": "10.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "10.00",
        "currency_code": "USD"
      }
    },
    "total_shipping_price_set": {
      "shop_money": {
        "amount": "0.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "0.00",
        "currency_code": "USD"
      }
    },
    "subtotal_price_set": {
      "shop_money": {
        "amount": "597.00",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "597.00",
        "currency_code": "USD"
      }
    },
    "total_price_set": {
      "shop_money": {
        "amount": "598.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "598.94",
        "currency_code": "USD"
      }
    },
    "total_tax_set": {
      "shop_money": {
        "amount": "11.94",
        "currency_code": "USD"
      },
      "presentment_money": {
        "amount": "11.94",
        "currency_code": "USD"
      }
    },
    "admin_graphql_api_id": "gid://shopify/Order/450789469",
    "line_items": [
      {
        "id": 466157049,
        "variant_id": 39072856,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008GREEN",
        "variant_title": "green",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - green",
        "variant_inventory_management": "shopify",
        "properties": [
          {
            "name": "Custom Engraving Front",
            "value": "Happy Birthday"
          },
          {
            "name": "Custom Engraving Back",
            "value": "Merry Christmas"
          }
        ],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 518995019,
        "variant_id": 49148385,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008RED",
        "variant_title": "red",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - red",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/518995019",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      },
      {
        "id": 703073504,
        "variant_id": 457924702,
        "title": "IPod Nano - 8gb",
        "quantity": 1,
        "sku": "IPOD2008BLACK",
        "variant_title": "black",
        "vendor": null,
        "fulfillment_service": "manual",
        "product_id": 632910392,
        "requires_shipping": true,
        "taxable": true,
        "gift_card": false,
        "name": "IPod Nano - 8gb - black",
        "variant_inventory_management": "shopify",
        "properties": [],
        "product_exists": true,
        "fulfillable_quantity": 1,
        "grams": 200,
        "price": "199.00",
        "total_discount": "0.00",
        "fulfillment_status": null,
        "price_set": {
          "shop_money": {
            "amount": "199.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "199.00",
            "currency_code": "USD"
          }
        },
        "total_discount_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
        "tax_lines": [
          {
            "title": "State Tax",
            "price": "3.98",
            "rate": 0.06,
            "price_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            }
          }
        ]
      }
    ],
    "shipping_lines": [
      {
        "id": 369256396,
        "title": "Free Shipping",
        "price": "0.00",
        "code": "Free Shipping",
        "source": "shopify",
        "phone": null,
        "requested_fulfillment_service_id": null,
        "delivery_category": null,
        "carrier_identifier": null,
        "discounted_price": "0.00",
        "price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discounted_price_set": {
          "shop_money": {
            "amount": "0.00",
            "currency_code": "USD"
          },
          "presentment_money": {
            "amount": "0.00",
            "currency_code": "USD"
          }
        },
        "discount_allocations": [],
        "tax_lines": []
      }
    ],
    "billing_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "shipping_address": {
      "first_name": "Bob",
      "address1": "Chestnut Street 92",
      "phone": "555-625-1199",
      "city": "Louisville",
      "zip": "40202",
      "province": "Kentucky",
      "country": "United States",
      "last_name": "Norman",
      "address2": "",
      "company": null,
      "latitude": 45.41634,
      "longitude": -75.6868,
      "name": "Bob Norman",
      "country_code": "US",
      "province_code": "KY"
    },
    "fulfillments": [
      {
        "id": 255858046,
        "order_id": 450789469,
        "status": "failure",
        "created_at": "2019-10-16T16:01:19-04:00",
        "service": "manual",
        "updated_at": "2019-10-16T16:01:19-04:00",
        "tracking_company": null,
        "shipment_status": null,
        "location_id": 905684977,
        "tracking_number": "1Z2345",
        "tracking_numbers": [
          "1Z2345"
        ],
        "tracking_url": "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345",
        "tracking_urls": [
          "https://www.ups.com/WebTracking?loc=en_US&requester=ST&trackNums=1Z2345"
        ],
        "receipt": {
          "testcase": true,
          "authorization": "123456"
        },
        "name": "#1001.0",
        "admin_graphql_api_id": "gid://shopify/Fulfillment/255858046",
        "line_items": [
          {
            "id": 466157049,
            "variant_id": 39072856,
            "title": "IPod Nano - 8gb",
            "quantity": 1,
            "sku": "IPOD2008GREEN",
            "variant_title": "green",
            "vendor": null,
            "fulfillment_service": "manual",
            "product_id": 632910392,
            "requires_shipping": true,
            "taxable": true,
            "gift_card": false,
            "name": "IPod Nano - 8gb - green",
            "variant_inventory_management": "shopify",
            "properties": [
              {
                "name": "Custom Engraving Front",
                "value": "Happy Birthday"
              },
              {
                "name": "Custom Engraving Back",
                "value": "Merry Christmas"
              }
            ],
            "product_exists": true,
            "fulfillable_quantity": 1,
            "grams": 200,
            "price": "199.00",
            "total_discount": "0.00",
            "fulfillment_status": null,
            "price_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_discount_set": {
              "shop_money": {
                "amount": "0.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "0.00",
                "currency_code": "USD"
              }
            },
            "discount_allocations": [],
            "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
            "tax_lines": [
              {
                "title": "State Tax",
                "price": "3.98",
                "rate": 0.06,
                "price_set": {
                  "shop_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  },
                  "presentment_money": {
                    "amount": "3.98",
                    "currency_code": "USD"
                  }
                }
              }
            ]
          }
        ]
      }
    ],
    "client_details": {
      "browser_ip": "0.0.0.0",
      "accept_language": null,
      "user_agent": null,
      "session_hash": null,
      "browser_width": null,
      "browser_height": null
    },
    "refunds": [
      {
        "id": 509562969,
        "order_id": 450789469,
        "created_at": "2019-10-16T16:01:19-04:00",
        "note": "it broke during shipping",
        "user_id": 799407056,
        "processed_at": "2019-10-16T16:01:19-04:00",
        "restock": true,
        "admin_graphql_api_id": "gid://shopify/Refund/509562969",
        "refund_line_items": [
          {
            "id": 104689539,
            "quantity": 1,
            "line_item_id": 703073504,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 703073504,
              "variant_id": 457924702,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008BLACK",
              "variant_title": "black",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - black",
              "variant_inventory_management": "shopify",
              "properties": [],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/703073504",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          },
          {
            "id": 709875399,
            "quantity": 1,
            "line_item_id": 466157049,
            "location_id": 487838322,
            "restock_type": "legacy_restock",
            "subtotal": 199.0,
            "total_tax": 3.98,
            "subtotal_set": {
              "shop_money": {
                "amount": "199.00",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "199.00",
                "currency_code": "USD"
              }
            },
            "total_tax_set": {
              "shop_money": {
                "amount": "3.98",
                "currency_code": "USD"
              },
              "presentment_money": {
                "amount": "3.98",
                "currency_code": "USD"
              }
            },
            "line_item": {
              "id": 466157049,
              "variant_id": 39072856,
              "title": "IPod Nano - 8gb",
              "quantity": 1,
              "sku": "IPOD2008GREEN",
              "variant_title": "green",
              "vendor": null,
              "fulfillment_service": "manual",
              "product_id": 632910392,
              "requires_shipping": true,
              "taxable": true,
              "gift_card": false,
              "name": "IPod Nano - 8gb - green",
              "variant_inventory_management": "shopify",
              "properties": [
                {
                  "name": "Custom Engraving Front",
                  "value": "Happy Birthday"
                },
                {
                  "name": "Custom Engraving Back",
                  "value": "Merry Christmas"
                }
              ],
              "product_exists": true,
              "fulfillable_quantity": 1,
              "grams": 200,
              "price": "199.00",
              "total_discount": "0.00",
              "fulfillment_status": null,
              "price_set": {
                "shop_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "199.00",
                  "currency_code": "USD"
                }
              },
              "total_discount_set": {
                "shop_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                },
                "presentment_money": {
                  "amount": "0.00",
                  "currency_code": "USD"
                }
              },
              "discount_allocations": [],
              "admin_graphql_api_id": "gid://shopify/LineItem/466157049",
              "tax_lines": [
                {
                  "title": "State Tax",
                  "price": "3.98",
                  "rate": 0.06,
                  "price_set": {
                    "shop_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    },
                    "presentment_money": {
                      "amount": "3.98",
                      "currency_code": "USD"
                    }
                  }
                }
              ]
            }
          }
        ],
        "transactions": [
          {
            "id": 179259969,
            "order_id": 450789469,
            "kind": "refund",
            "gateway": "bogus",
            "status": "success",
            "message": null,
            "created_at": "2005-08-05T12:59:12-04:00",
            "test": false,
            "authorization": "authorization-key",
            "location_id": null,
            "user_id": null,
            "parent_id": 801038806,
            "processed_at": "2005-08-05T12:59:12-04:00",
            "device_id": null,
            "receipt": {},
            "error_code": null,
            "source_name": "web",
            "amount": "209.00",
            "currency": "USD",
            "admin_graphql_api_id": "gid://shopify/OrderTransaction/179259969"
          }
        ],
        "order_adjustments": []
      }
    ],
    "payment_details": {
      "credit_card_bin": null,
      "avs_result_code": null,
      "cvv_result_code": null,
      "credit_card_number": "•••• •••• •••• 4242",
      "credit_card_company": "Visa"
    },
    "customer": {
      "id": 207119551,
      "email": "bob.norman@hostmail.com",
      "accepts_marketing": false,
      "created_at": "2019-10-16T16:01:19-04:00",
      "updated_at": "2019-10-16T16:01:19-04:00",
      "first_name": "Bob",
      "last_name": "Norman",
      "orders_count": 1,
      "state": "disabled",
      "total_spent": "199.65",
      "last_order_id": 450789469,
      "note": null,
      "verified_email": true,
      "multipass_identifier": null,
      "tax_exempt": false,
      "phone": null,
      "tags": "",
      "last_order_name": "#1001",
      "currency": "USD",
      "accepts_marketing_updated_at": "2005-06-12T11:57:11-04:00",
      "marketing_opt_in_level": null,
      "tax_exemptions": [],
      "admin_graphql_api_id": "gid://shopify/Customer/207119551",
      "default_address": {
        "id": 207119551,
        "customer_id": 207119551,
        "first_name": null,
        "last_name": null,
        "company": null,
        "address1": "Chestnut Street 92",
        "address2": "",
        "city": "Louisville",
        "province": "Kentucky",
        "country": "United States",
        "zip": "40202",
        "phone": "555-625-1199",
        "name": "",
        "province_code": "KY",
        "country_code": "US",
        "country_name": "United States",
        "default": true
      }
    }
  }
}
DELETE /admin/api/2020-01/orders/#{order_id}.json
Deletes an order. Orders that interact with an online gateway can't be deleted.

Delete an order

DELETE /admin/api/2020-01/orders/#{order_id}.json
View Response
HTTP/1.1 200 OK
{
}

Sign up for a Partner account to get started.

Sign up